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AUTHORING E-MAIL WITH A MODULAR COMPONENTS 
BACKGROUND OF THE INVENTION 

1 . Field of the Invention 

The invention relates to an electronic mail program. More particularly, the invention 
relates to an electronic mail program having modular integral authoring/reading applications 
whereby documents created with the modular integral authoring/reading applications are 
seamlessly sent and received by the mail program. 

2. State of the Art 

In recent years electronic mail ("email") has become widely used in business, education, 
and in personal communications. One of the features of electronic mail which is most 
convenient, particularly in business and in education, is the ability to attach a binary computer file 
to an email message. This feature enables email correspondents to rapidly share word 
processing documents, database documents, spreadsheet documents, multimedia documents, or 
virtually any kind of binary fde created by a computer. There are, however, some serious 
limitations and inconveniences associated with attaching a binary file to an email message. 

The original Internet mail system as defined in 1982 with RFC (Request for Comments) 
82 1 and 822 had a number of important limitations. In particular, the system was not designed 
to carry large quantities of arbitrary data in an email message. In fact, the 1982 SMTP (Simple 
Mail Transport Protocol) standard required that an email message consist of a single message 
containing only ASCII characters in lines of 1000 characters (blocks of 32k) or less. Moreover, 
some implementations of SMTP or other mail transport systems (such as UUCP) restricted 
message lengths to some allowed maximum number of bytes. Messages passing through a mail 
gateway using one of these implementations were likely to be truncated. 

The ability to send large quantities of binary data through the Internet electronic mail 
system was made possible with the MIME (Multipurpose Internet Mail Extensions) standard 
for Internet messages. The original MIME standard was published as an Internet Request For 
Comments document (RFC 1341) and approved in June of 1992. (See Internet RFCs 
2045,2046, and 2047 for the latest MIME standards documents.) The MIME standard 
describes how an email message should be formatted in order to be considered MIME 
compliant. MIME defines a set of message header fields and a set of message encoding 
standards that are designed to overcome the limitations of RFC 822 message formats and still be 
transportable through any of the numerous legacy mail transport systems in use on the Internet. 
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MIME message header fields extend those defined in 822 and describe the content and 
encoding type of the email message. Encoding schemes allowed in the NUME^standard include 
"quoted-printable". and "base64". In addition, three unencoded data types are allowed. These 
are labeled "8bit", "7bit", or "binary". , ; , 

If the sender and the receiver of the email message with the attached binary file are using 
the same brand and version of email program and both programs are configured in substantially 
the same way, the receiver's emaU program should automatically apply the appropriate decoding 
to the attached binary file and produce a file which is identical to the fUe which was attached to 
the email by the sender. However, if the sender and receiver are using different email programs, 
the recipient may receive a file which must be decoded by the recipient using a separate decoding 
program. Worse yet* if there is a failure of the.receiying email program to properly deal with the 
MIME protocol, it is possible that the. receiver will receive multiple files (each being < 32k) 
which must first be concatenated and then decoded. 

Even after the file is properly received and decoded, it is often difficult for the receiver of 
the file to open the fUe. The receiver of the file might expect that "clicking" on the file icon will 
open the file. However, clicking on the file-icon wiU often not open the, file. It may result in an 
error message like "appUcation not found" or, worse, it may result in the fUe being opened by an 
inappropriate application thereby displaying "gibberish". The receiver of the file must have a 
program capable of reading (opening) the file. For .example, if one attaches a spreadsheet file to 
an email message, the receiver of the file must have a spreadsheet program in order to open the 
file. Technically, it is not necessary that the receiver of the file have the same brand program as 
that which created the file. However, opening a file with a program, which did not create it, 
though possible, can be very inconvenient. The receiver of the file ,must know what kind of file 
is attached to the email message, must know what program on their computer is capable of 
reading that type of file, must launch the program, must open the file from within the program, 
> and vvait while the program translates the file. ^ ^ ' 

The limitations of Intemet electronic mail can become even more frustrating if the sender 
and recipient are not using the same operating system (OS). Some mail attachment encoding 
schemes (and file compression schemes) are OS-dependent and it is possible that an email 
recipient could receive a file which is impossible to decode (or decompress). 

These limitations in electronic mail have discouraged many people, particularly non- 
sophisticated computer users, from attaching files to electronic mail messages. In fact, for some 
novice users, the task of launching one application to create a document, saving the document. 
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launching a separate email application to create an email message, and then locating the saved 
document for attachment to an email message is daunting enough to discourage them. In 
addition, novice users often complain that after "downloading" a file attached to an email 
message they cannot find the file on their hard disk. 

SUMMARY OF THE INVENTION 

It is therefore an object of the invention to provide an electronic mail program which 
includes integrated authoring software whereby a document may be created and sent by email in 
a seamless manner. ' 

It is also an object of the invention to provide an electronic mail program which includes 
integrated authoring/reading software whereby a document may be received and opened in a 
seamless manner. 

It is another object of the invention to provide an electronic mail program which includes 
modular integrated authoring software whereby different kinds of documents may be created and 
sent by email in a seamless manner. 

It is still another object of the invention to provide an electronic mail program which 
includes modular integrated authoring/reading software whereby different kinds of documents 
may be received and opened in a seamless manner. 

It is another object of the invention to provide an electronic mail program which iricludes 
modular integrated.authorihg/reading software whereby the authoring/reading software and the 
email software present an interface which suggests tliat a single application is operating. 

It is another object of the invention to provide an electronic mail program which includes 
modular integrated mailbox handling software whereby messages of different types are 
displayed in different ways in a mailbox listing. 

It is still another object of the invention to provide an electronic mail program which 
includes modular integrated authoring/reading software wherein the functionality of the 
authoring/reading software is controlled by the "role" of the user when participating in an 
exchange of messages. 
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In accord with these objects which will be discussed in.detail below, the electronic mail 
software of the present invention includes a main email component and a number of installable 
components which communicate bidirectionally with the email component. The installable 
components include authoring/reading components as weU as at least one mailbox 
browser/editor component. The main email component provides an underlying graphical user 
interface (GUI) for functions directly associated with the storage and transfer of electronic mail 
messages. In particular, the main email component provides menu items which allow the user to 
SEND, I^AD, REPLY, FORWARD, DELETE, SAVE, PRINT, for example. The main emaU 
program also handles all data bundling and unbundling that may be required to transform a 
message created by an authoring component into a fully MIME compliant message. In addition, 
the main email component includes "hooks" (an application programming interface or API) for 
the attachment of the installable components. The authoring/reading components each provide 
functionality which is particular to the type of document the component is designed to 
create/display. For example, a text document authoring component includes word processing 
functionality such as font selection, margin setting, etc. A painting/drawing authoring 
component includes tools for line drawing, polygon creation, paint bmsh, paint can, eraser, etc. 
A spreadsheet authoring component displays a grid and includes formula creation tools as well 
as formatting tools. A database authoring tool includes tools for creating fields and records, for 
sorting and searching, for generating reports, etc. A photo editor authoring component includes 
various imaging editing tools including cropping tools, dodging and burning tools, fUters, etc. A 
presentation authoring component includes tools for creating slides and slide shows. The 
authoring components act like applications embedded within the email program and allow 
specific types of documents such as spreadsheets, graphics, databases,,etc. to be created from 
within the email program and emailed directiy. In addition, the authoring components allow 
received spreadsheets, grapliics, databases, etc. to be read by the email program without the 
difficulties traditionally associated with attaching. binary files to an email letter. According to the 
invention, in lieu of authoring components which allow both authoring and reading, separate 
components may be provided for authoring and reading, or components for reading only may be 
provided in addition to components which permit authoring as well as reading., The 
authoring/reading cornponerits interface with the main email component via designated "MIME 
types". The MIME data standard allows developers to define MIME types using the label 
'7appUcation-x" in the data header. The authoring components of the invention pass data to the 
main email component wliich packages the data as a MIME compUanf message with the label 
"/application-x" in the message header, where x identifies the authoring/reading component 
which created/can display tiie message. When the message is received, the main email 
component concatenates and decodes the MIME message, reads the MIME type, sends the data 
to the component associated with the MIME type, and waits for a user event or a callback from 
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the component. This bidirectional communication between the main emaU component and the 
authoring/reading 'components provides a totally seamless operation wherein the user may send 
and receive complex documents without any knowledge of attaching files, downloading, 
decoding, etc. • 

The mailbox browser/editor (mailbox handler) component is provided preferably as a 
separate component rather than as part of the main eniail component so that the software may be 
more easily customized and upgraded. The mailbox browser/editor component is used to 
display, edit, and browse mailboxes. Since the invention provides for email messages which 
contain different kinds of data, the features of the mailbox browser may depend on the type of 
messages being sent and received. For example, if a graphical authoring/reading component is 
installed, it may be desirable to provide a. mailbox browser which shows a thumbnail of the 
selected graphic email message when a list of messages is displayed. 

The software according to the invention provides a single seamless environment for 
authoring, reading, and emailing a variety of different types of documents. The user does not 
need to understand uploading, downloading, file types, file decoding, or any of the other esoteric 
requirements of attaching files to email. Further, the user does not need to know what kind of 
application must be launched in order to read a particular type of email message. 

An exemplaiy embodiment of the invention is an email program for school children 
called KIDCODE®. The KIDCODE® program includes a main email component, a mailbox 
browser/editor component and several message authoring/reading components. The main email 
component and the mailbox browser/editor component provide the same functionality as . 
described above.' Additional KIDGODE® components include a text authoring tool, rebus game 
message haridler components (encoding and decoding components) which allow children to 
create' and irespond to graphical rebus niessages,vseveral,different ganie puzzle componerits, and a 
workbook which allows a teacher, to, send workbook problems to a student and allows the 
student to send the solved problems back tO;the teacher. According to one inventive aspect of the 
invention, which is? exemplified in the wqrkbook and rebus components, an authoring/reading 
component may assign and track user -roles" by associating a role tag to each message. For 
example, in the rebus component, the user initiating the rebus exchange will be assigned the role 
of rebus encoder. The message created by this user will contain a tag identifying it as an 
"encoded message". When the message is opened by the recipient, the tools available in.the 
rebus component will be different from those available if a message were being encoded, 
Similarly, the workbook component is preferably provided with a teacher role and a student role, 
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each Of Which have different tools. Component roles may be selected by the users, assigned by 
the system administrator, or automatically by components when messages are created/read. 

According to a presently preferred embodiment, the KIDCODE® cUent software is 
written in the MACROMEDIA DIRECTORtm LINGO™ scripting language which is cross- 
platform and thus ideally suited for use in schools which typically have a combination of 
MAC/OSTM and WINDOWS^m computers. As implemented, the client software operates over 
a TCP/IP LAN which is the most common type of network used in schools today and is 
compatible with the Internet. According to a further implementation of the invention, 
KIDCODE® software permits messages to be sent via the Internet in >MLME compliant format. 

Additional objects and advantages of the invention wiU become apparent to those skilled 
in the art upon reference to the detailed description taken in conjunction with the provided 
figures. 

BRIEF DESCRIPTION OF THE DRAWINGS 
Figure 1 is a screen shot of the KIDCODE® client login screen; 

Figure la is a simplified state diagram iUustrating the entry from the login screen to the 
main email component of the KIDCODE® software; 

Figure 2 is a screen shot of the KIDCODE® main email component screen, she wing a 
menu of the installed authoring/display components and the mailbox browser component; 

Figure 2a is a simplified state diagram illusttating the entry from the main email . . . 
component into the installed components; 

Figure 3 is a screen shot of the KIDCODE® mailbox browser/editor component screen; 
Figure 4 is a screen shot of thte KIDCODE® text message authoring component screen; 
Figure 5 is a screen shot of the KIDCODE® rebus authoring (encoding) component 

screen; 



Figure 6 is a screen shot similar to Figure 5 illustrating a listbox of users on the network 
to whom mail may be sent; 
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Figure 7 is a screen shot similar to Figure 5 illustrating a rebus in the process of being 
coded by the user; 

Figure 8 is a screen shot of the iODCODE® rebus reading (decoding) component 
4 screen; : . 

Figure 9 is a screen shot, of the KIDCODE® workbook authoring component screen; 

Figure 10 is a screen shot illustrating the main email component of a second embodiment 
of the invention; 

Figure 11 is a screen shot illustrating a text authoring component in the second 
embodiment of the invention; 

Figure 12 is a screen shot illustrating a painting/drawing authoring component in the 
second embodiment of the invention; 

Figure 13 is a screen shot illustrating a spreadsheet authoring component in the second 
embodiment of the invention; 

Figure 14 is a screen shot illustrating a database authoring component in the second 
embodiment of the invention; 

Figure 15 is a screen shot illustrating a photo editor authoring component in the second 
embodiment of the invention; . . . . . 

Figure 16 is a screen shot illustrating a slide show authoring component in the second 
embodiment of the invention; and ; . . : . • . 

^ Figure 1*7 is a screen shot illustrating a display-only coniponent in the second 
'i embodiment of the invention. 

BRIEF DESCRIPTION OF THE APPENDICES 

Appendix A is the LINGO^^ script implementation of the KIDCODE® main email 
component; 
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Appendix B is a description of the Application Programming Interface for the 
KIDCODE® main email component which enables installable components to operate with the 
main email component. • . . 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 

As menuoned above, a presently implemented embodiment of the invention is realized 
utilizing the MACROMEDIA DIRECTOR LINGO^m scripting language. The DIRECTOR™ 
appUcation was originally intended to be used for authoring interactive multimedia presentations. 
Therefore, many of the terms used in the LINGO language refer to multimedia objects such as 
movies, cast members, frames, and sprites. However, it has been found. that the LINGO^m 
language can be used to author many different types of programs including programs which 
were not traditionally thought of as being multimedia presentation programs. The foUowing 
description, therefore, of the presently implemented embodiment will be best understood by 
those familiar with the MACROMEDIA DIRECTOR LINGO™ scripting language. However, 
those skilled in the art wUl understand from the functional description which follows that the 
invention could be impleniented in other languages such as C or C++, JAVA™, etc. 

Referring now to Figures 1 and la, and with reference to Appendix A, the first screen 10 
presented by the KIDCODE® program is preferably a login screen where the user enters his or 
her name and password. According to the presently preferred embodiment, the login name field 
12 is implemented as a popup menu (or pull down list box) and the password field 14 is a 
standard text entry field. See, for example, lines 172-190 of Appendix A. Clicking on the login 
name field will make a list of names appear and allow the user to highlight one of the names 
using the mouse. After the user has selected a name and typed in a password, the Okay button 
16 must be clicked, or the Return or Emer key may be pressed. See Appendix A, lines 796-846 
axid lines '879-899. At this screen 10, the only option available under the FILE menu, is QUIT. 
According to the presently preferred embodiment, the usemames and passwords are stored in 
■ associative (two property) Usts so that a password.may.bb associated with a usemame and a 
usemame may be associated with a password.' When the okay button is clicked, the software 
checks the validity of the usemame and password. The checking of the usemame and password 
is illustrated in the state diagram in Figure la. Starting at 20 in Figure la, if the user selects a 
usemame and clicks the okay button, the password field is checked at 22. If no password was 
entered, a popup message is displayed at 24 indicating to the user that a password must be 
entered and the system returns to start at 20 waiting for the user to click the okay button. If the 
user types in a password and clicks the okay button, the usemame field is checked at 26. If no 
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usemame was selected, a popup message is displayed at 24 indicating that a usemame must be 
selected and the system returns to stait at 20 waiting for the user to click the okay button. If the 
user types in a password and selects a usemame, it is determined at 28 or 30 whether the 
usemame and password match, and if they do, the software enters to the main email component 
at 32. If the usemame and password do not match, a popup message is displayed at 34 
indicating that the password entered is invalid for the usemame selected and the system returns 
to start at 20 waiting for the user to click the okay button. If the usemame and password are that 
of the system administrator, a special administration display will be shown in which usemames 
and passwords may be added/deleted to/froni the system. See Appendix A lines 858-875, 900- 
1016, and 1123-1140. • . 

Turning now to Figures 2 and 2a, once the user has selected a usemame and entered the 
correct password, the program displays the screen 40 shown in Figure 2 (Appendix A lines 85 1- 
855). This is the screen of the main email component with no other component selected. The 
screen 40 includes a scrollable collection of icons 42, 44, 46, 48, 50 and includes buttons 52, 54, 
56 for mailbox access and button 58 to quit the program. The icons 42, 44, 46, 48, and 50 
represent the installed authoring/reading components. As shown in Figure 2, the icons represent 
a text component 42, a rebus component 44, a "text in grid" component 46, a puzzle component 
48, and a "connect the dots" component 50. As illustrated in Figure 2a, starting at 60, if the user 
clicks on the text icon, the program will, at 62, open; the text authoring component with an empty 
message (Appendix A lines 1422-1438 and 1025-1054), Similarly, if the user clicks on the 
rebus icon; the program will, at 64, open the rebus authoring component with an empty message 
(Appendix A lines 1442-1458 and- 1025-1054). The main email component will also, when an 
authoring component is opened, make the print, trashy and send buttons visible as these functions 
are served by the main email component as illustrated in Figure 2a (Appendix A lines 489-526 
and 1456). Since the presently implemented example does not yet have all components 
" complete, the launching of other components is shown generically at 66 in Figure 2a. .When a 
component is launched, the main' email- program suspends execution at 68 awaiting any "call 
back" frorh the launched component; .The' API described in Appendix B includes a set of "call 
back" functions that can be used by an authoring or mailbox component to communicate with 
the main email component. See Appendix B pages 4-7 and Appendix A lines 557-744. Further, 
the main email component serves the email functions of inbox, outbox, and filing cabinet for 
messages that have not been sent. These functions are illusU*ated in Figure 2 as buttons 52, 54, 
56 and in Figure 2a as routines 72, 74, 76. 

For example, as shown in Figure 3, when the user enters the inbox, a window 78 and a 
button bar 80 are displayed. The mailbox component with the appropriate set of messages is 
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launched as shown in Appendix A Unes 1533-1558 and 216-247). The window 7,8 displays a 
list of new email and the button bar 80 displays buttons for functions common to all 
components, i.e. buttons for reply 82, send 84. print 86. and trash 88. It will be understood that 
depending on whether the user is in an authoring or reading mode, either the reply button 82 or 
the send button 84 will be "grayed out" indicating that that option is not available. As shown in 
Figure 3, for example, the send button 84 is not available when/looking at the mail inbox. It will 
also be appreciated that the buttons and icons from the previous screen (Figure 2) are no longer 
visible. As stated in Figure 2a, the user returns to the screen of Figure 2 when the window 78 is 
closed. ' - 

The presently implemented text authoring/reading component is illustrated in the 
authoring mode in Figure 4. The window 90 is similar to any email message authoring tool and 
includes fields for "to:" 92, "from:" 94. "date" 96, "subject" 98, and "message" 100. The 
"from:" field 94 and "date" field 96 are hidden in Figure 4 behind the scrollable list box 102. 
After the addressee is chosen from the list box 102, the box disappears and reveals the "from" 
and "date" fields. According to the presently preferred embodiment, the list box 102 lists the 
names of all of the users registered in, the local email system. This is handled by a call to the 
API as indicated at Appendix A lines 726-73 1 . Thus, this embodiment prevents users from 
sending a document to a recipient who is not registered with the system administrator. It also 
allows users of the system to address messages without typing the recipient's name. According 
to another embodiment of the invention, shown and described, below with reference to Figure 10, 
users are permitted to send email to any internet address and a list box is optionally used to 
display an address book. As seen in Figure 3, the reply button 82 in the button bar 80 is grayed 
out because that function is not available when authoring a text message. This is accomplished 
in Appendix A at lines 1422-1438. ' - . ' v 

Figures 5-8 illustrate the presently implemented rebus component. The rebus 
component presents a window 104 which includes a "to:" .field 106, a message area 108,,a "T" 
button 1 10 for selecting a template; sentence, an "S" button 1 12 for hiding/displaying symbols, a 
"-" button 114 for hiding/displaying guesses, and a scrollable area 1 1.6 to the right of the 
liiessage area which displays sets of symbols tb be used in coding a rebus. In addition, the 
rebus component displays several pull down menus which are particular to it. These include the 
template choices menu 1 1 8 and the symbol choices menu 120. 

According to the presently implemented embodiment, the author of a rebus begins by 
selecting a template sentence from a selection of sentences which are capable of being expressed 
as a rebus using the symbol sets provided. The template selection may be made via the T button 
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1 10 or the pull down menu 1 18. When a template sentence is selected, a suggested set of 
symbols is displayed in the field 1 16. Different symbols may be viewed by selecting a symbol 
set from the Symbol Choices menu 120. As illustrated in Figure 8, symbols are grouped 
according to the kinds of words they symbolize such as "action symbols'*, "object symbols", 
"quantity symbols", etc. As with other components of the KIDCODE® program, and as shown 
in Figure 6, the "to:" field 106 presents a drop down or pop up list box through which the email 
is addressed by selecting a registered user. 

The author of the rebus codes the template sentence by dragging symbols from the 
scrollable field 1 16 to the message area 108. This is best illustrated by Figure 7. Symbols, 
when placed on a coded word in the template sentence, will snap into place when they are 
dragged into the area 108. According to the invention, not every word in the template sentence is 
designed to be coded with a symbol. According to the presently preferred embodiment, words 
which are to be coded appear in red text. For example, as shown in Figure 7, two symbols have 
been dragged into the message area and have snapped over the now hidden words "threw" and 
"window". The words "ball and "through" are also red text and can be coded with a proper 
symbol. The author can hide the symbols and display the words in the sentence which are 
covered by symbols by clicking on the "S" button 1 12. However, when the recipient receives the 
rebus; clicking on the button "S" will not reveal the words beneath the symbols, but will only 
make the symbols disappear. This is an example of how user "roles" alter the tools available in a 
component. When the author finishes coding the rebus, he or she cHcks on the send button 84. 
The main email component then automatically encodes the rebus as a MIME attachment to 
Internet mail and sends the mail to the recipient's mailbox. 

Turning now to Figure 8, when the recipient of the rebus opens the email message 
containing a rebus, the KIDCODE® main email component automatically decodes the MIME 
attachment, determines that it is a rebus, and opens it in the rebus reading cornponent. The 
message'appears with empty text boxes (e.g. 122, 124, 126) beneath the graphic symbols. The 
recipient of the message must solve the rebus by typing in the text boxes the words which he/she 
believes are represented by the graphic:symbols. As rnentioned above, the "-" button 1 14 is for 
hiding/displaying the guesses typed in the boxes. When the recipient has typed in words for all 
the graphic symbols, he/she clicks on the reply button 82 to send the solution back to the author. 
Figure 8 shows the screen after the button 82 has been clicked. Thus it is grayed out to prevent 
the same message from being sent twice. The palette 1 16 is available to the decoder for 
browsing only. The features which allow symbols to be placed on the message are disabled for 
the decoder. . 
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One of the authoring/reading components of the invention is a workbook message 
handler, an example of which is iUustrated in Figure 9. The screen shot shown in Figure 9 
illustrates the "student role" of a workbook message handler. The window 130 of the student 
role workbook message handier preferably includes "to:" and "from:" fields 132, 134 which are 
filled in by the teacher before the message is sent to the student, as weU as six fields 136, 138, 
140, 142, 144, 146 which must be filled in by the student before the message is returned to the 
teacher. As shown in Figure 9. the window 130 also includes a title. 148, a date 150 and various 
instructions 152. Those skilled in the art wUl appreciate that the date . 150 may be automatically 
entered when the message is sent to the student. The fields. 136, 138, 140, 142,,. 144, 146, the title 
148, and the instructions 152 may be m.anually entered by the teacher or may be selected as part 
of a template. In other words, the workbook message handler component may be. a complex tool 
which allows teachers to author an infinite number of "problem messages" to smdents or it may 
be a modular set of pre- written problems or templates for problems. The workbook message 
handler component preferably includes many pre-written problems. Additional pre- written 
problems will be available through additional modular components. One important feature of the 
workbook message handler components is that they identify user status and automatically 
present the proper "role" of either teacher or student. . 

The KIDCODE® program described above is designed to be easy to use by yery young 
children. Figures 10-17 iUustrate another embodiment of the invention which is designed for a 
more sophisticated user, an older child, or an adult. The interface is more complicated, but offers 
the user more features. Refening now to Figure 10, the interface of the second embodiment of 
the invention includes a menubar 200 which lists some standard menus like FE.E, EDIT, , 
SETUP, WINDOW, and HELP. The menubar 200.may also include a clock display 202 which 
is typically supplied by the operating system and a. blinking icon 204 >vhiqh is typically supplied 
by TCP/IP connection software such as PPP dialup software; to indicate that the computer is 
connected to the Internet. The menus MAIL arid FOLDER in >the menubar 200 are particular to 
thfe emailing program and the scroll icon 206 is provided by. scripting software, typically part of 
the operating system. Under the MAIL menu, one will find commands such as NEW for 
creating new^ mail, REPLY for replying to a mail message being read* FORWARD,, ^tc Under 
the FOLDER menu, one will find the names of user created filing cabinets (folders) where 
incoming mail can be saved. Under the SETUP, menu, one will find commands for setting the 
necessary information to make a connection with the Internet, for storing the user's name and 
password, for scheduling automatic sending and receiving of mail, for performing automated 
tasks in response to mail (e.g. for automatically filing certain mail in certain folders, , 
'■ autoresponding to certain maU, etc.), etc. Under the WINDOW menu, the user will have the 
option of viewing INBOX, OUTBOX. FILING CABINET(s), CONNECTION STATUS, etc. 
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The HELP menu preferably provides a context sensitive alphabetical list of help items which are 
hot linked to html files. 

Figure 10 illustrates the email program with a new outgoing message window 208 
opened. The message window includes a standard text message field 210, a standard subject 
field 212, standard multiple recipient address fields 214, and a variety of buttons. The arrow 
buttons 216 allow the user to scroll among messages in the outbox. The outbox button 218 
drops down a list of items in the outbox, from which items may be selected. The magnifying 
glass button 220 is used to search the user's address book. The button 222 adds a recipient 
to the address field 214. The trash button 224 places the outgoing message in the trash and 
closes the window 208. The clock button 226 brings up a menu to schedule when the message 
will be sent. The rotating arrow button 227 causes the address fields 214 to disappear/reappear 
thereby expanding/contracting the size of the message field 210. The send button 228 sends the 
message to the outbox (if it is scheduled for delivery at another time or if the computer is not 
connected to the Internet) and sends the message otherwise. The button 230 labelled " -^-K" 
causes the computer to connect to the Internet. As shown in Figure 10, this button 230 is grayed 
out because, as indicated by the bUnking telephone pole icon 2Q4, the computer is already 
connected to the Internet. The "send via" button 232 allows the user to select from several 
usemanies, email accounts, etc. 



The outgoing message window 208 shown inFigure 10 allows the user to send standard 
Internet mail by typing a message in the window 210. However, according to the invention, the 
window 208 also includes buttons 234, 236, 238, 240, 242, and 244, each of which is linked to 
an installed authoring/reading component. As described above, the number and nature of the 
authoring/reading components is modularly changeable. In the example shown in Figure. 10, six 
authoring/reading components are shown to be installed; In practice, more, fewer, and/or , 
different cbmponents may be iristalled; VThe components shown and described herein are; a 
word processor authoring/reading component Jinked to the, button 234, a painting/drawing 
authoring/reading component hnked to. the button 236, a spreadsheet authoring/reading 
component linked to the button 238, a database authoring/reading component linked to the 
button 240; an image editor authoring/reading component hnked to. the button 242, and a 
presentation authoring/reading component linked to the button 244. 

Turning now to Figure 1 1, when the user clicks on the button 234, the word processor 
component is invoked and it causes a new menubar 250 and a ruler 252 to appear inside the 
message field 210 of the window 208. The word processor component allows sophisticated 
formatting of messages which would be impossible in a normal Internet email program. For 
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example, margins can be set using the ruler 252; fonts can be changed using the FONT menu 
from the menubar 250; tables can be created and inserted using the TABLE menu from the 
menubar 250. In general, the menubar 250 provides much or all of the functionality of a full 
feanired word processor program. Those skilled in the art will appreciate that the word 
processor interface shown in Figure 1 1 is similar to the interface of Microsoft® Word® 98. It 
will be noted that the menubar 250 provides a separate HELP menu in addition to the HELP 
menu provided on the menubar 200. It will be appreciated that the HELP menu could be omitted 
from the menubar 250 and the help files for the word processor component could be accessed 
from the main HELP menu on the menubar 200. It wiU also be noted that when the word 
processor component is invoked, the button 234 is grayed. 

After a user creates a message with the word processor component, the addressing and 
mailing procedure is the same as sending an ordinary email. ■ There is no need to save a file, 
encode it, or attach it to an email message. The main email component of the invention, 
seamlessly performs all of the saving, encoding, and attaching without any of this being exposed 
to the user. More particularly, the authoring component and the main email component 
cooperate to save the authored document as a file on the user's disk. See Appendix B lines 229- 
238 and Appendix A lines 1293- 1333 and 329-450. The main email component encodes the file 
in the MIME format with as many parts as necessaiy, and sends the MIME file(s) as Internet 
email message(s). When the message is received by a person using a copy of the email program 
of the invention, the receiver's main emaU component seamlessly concatenates the MIME pans, 
decodes the MIME file determines that it is a message created with the word processing 
component (Appendix A lines 690-694), invokes the word processing component (Appendix A 
lines 1019-1054), and opens the message with the word processing component (Appendix A 
lines 603-614). The receiver of the message does not have to download any file, find any 
attachment, execute any decoders, or launch any word processor to see the fully formatted 
document created by the sender. ■ ■ ' ; . ; : . 



■ Turning now to Figure 12, when the userclicks on the button:236; the painting/drawing 
component is invoked and it causes a new menubar 260 and a tool palette 262 to appear inside 
the message field 2 10 of the vvindow 208. The painting/drawing component allows the author to 
create a painting (bitmap) graphic or a drawing (vectormap) graphic and send it to another user 
for viewing/editing. Those skilled in the art wUl appreciate that the menubar 260 and palette 262 
shown in Figure 12 contain the menus and tool icons typically found in a full feanired 
drawing/painting program. Those skilled in the art will appreciate that the painting/'drawing 
component interface shown in Figure 12 is similai- to the interface of Aldus® SuperPaint® 3.5. 
It will be noted that the menubar 260 provides a separate HELP menu in addition to the HELP 
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menu provided on the menubar 200. It will be appreciated that the HELP menu could be ooiitted 
from the menubai' 260 and the help files for the painting/drawing component could be accessed 
from the main HELP menu on the menubar 200. It will also be noted that when the 
painting/drawing component is invoked, the button 236 is grayed. 

After a user creates a graphic image with the painting/drawing component, the addressing 
and mailing procedure is the same as sending an ordinary email There is no need to save a file, 
encode it, or attach it to an email message. The main email component of the invention 
seamlessly performs all of the saving, encoding, and attaching without any of this being exposed 
to the user. See Appendices A, E and F. When the message is received by a person using a copy 
of the email program of the invention, the receiver's main email component seamlessly 
concatenates N4IME parts, decodes the MIME file, determines that it is a message created with 
the painting/drawing component, invokes the painting/drawing component, and opens the 
message with the painting/drawing component. The receiver of the message does not have to 
download any file,- find any attachment, execute any decoders, or launch any painting/drawing 
program to view/edit the graphic image created by the sender. See Appendices A, E and F. 

Turning now to Figure 13, when the user clicks on the button 238, the spreadsheet 
component is invoked and it causes a new menubar 270, a grid 272, and a tool palette 274 to 
appear inside the message field 210 of the window 208. The spreadsheet component allows the 
author to create a spreadsheet and send it to another user for viewing/editing. Those skilled in 
the art will appreciate that the menubar 270 and palette 274 shown in Figure 13 contain the 
menus and tool icons typically found irii a full featured spreadsheet program. Those skilled in 
the art will appreciate that the interface of the spreadsheet component shown in Figure 13 is 
similar to the interface of Microsoft® Excel® 98. It will be noted that the menubar 270 provides 
a separate HELP menu in addition to the HELP menu provided on the menubar 200. It will be 
appreciated that the HELP menu could be omitted from the menubar 270 and. the help files for 
the spreadsheet component could be accessed from the main HELP menu on the menubar 200. 
It will also be noted that when the spreadsheet component is invoked, the button 238 is grayed. 

After a user creates a spreadsheet with the spreadsheet component, the addressing and 
mailing procedure is the same as sending an ordinary email. There is no need to save a file, 
encode it, or attach it to an email message. The main email component of the invention 
seamlessly performs all of the saving, encoding, and attaching without any of this being exposed 
to the user. See Appendices A, E and F. When the message is received by a person using a 
copy of theemail program of the invention, the receiver's main email component seamlessly 
concatenates MIME parts, decodes the MIME file, determines that it is a message created with 
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the spreadsheet component, invokes the spreadsheet component, and opens the message with the 
spreadsheet component. The receiver of the message does not have to download any file, find 
any attachment, execute any decoders, or launch any spreadsheet program to view/edit the 
spreadsheet created by the sender. See Appendices A, E and F. : . , 

Turning now to Figure 14, when the. user clicks on the button 240, the database 
component is invoked and it causes a new menubar 280, a record selection tool 282, and a free 
form space 284 to appear inside the message field 210 of the window 208., The database 
component allows the author to create a database and one or more reports and forms associated 
with the database and send it to another user for viewing/editing. Those skilled in, the art. will 
appreciate that the button bar 286 and the data fields 288 are defined by the author of the 
database using authoring tools found in the menus of the menubar 280. In fact, those skilled in 
the art wUl appreciate that the database interface shown in Figure 14 is similar to the interface of 
Filemaker®Pro 3.0. It will be noted that the menubar 280 provides a separate HELP menu in 
addition to the HELP menu provided on the menubar 200. It will be appreciated that the HELP 
menu could be omitted from the menubar 280 and the help files for the database component 
could be accessed from the main HELP menu on the menubar 200. It will also be noted that 
when the database component is invoked, the button 240 is grayed. 

After a user creates a database with the database component, the addressing and mailing 
procedure is the same as sending an ordinary email. There is no need to save a file, encode it, or 
attach it to an email message. The main email component of the invention seamlessly performs 
all of the saving, encoding, and attaching without any of this being exposed to the user. See 
Appendices A, E, and F. When the message is received by a person using a copy of the email 
program of the invention, the receiver's main email component seamlessly concatenates MIME 
parts, decodes the MIME file, determines that ifcis a message created with the-database 
component, invokes the database component, and opens the message with the database ^ 
component. The receiver of the message does not have to download any file, find any 
attachment, execute any decoders, or launch any database program to view/edit the database 
created by the sender. See Appendices A, E, and; F. . , ■ *. 

Turning now to Figure 15, when the user clicks on the button 242, the image editing 
component is invoked and it causes a new menubar 290 and a floating tool palette 292 to appear 
inside the message field 2 10 of the window 208. The image edifing component allows the 
author to edit an image and send it to another user for viewing and/or fiirther editing. Those 
skilled in the art will appreciate that the menubar 290 and palette 292 shown in Figure 15 contain 
the menus and tool icons typically found in a full featured image editing program. Those skilled 
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in the aft will appreciate that the interface of the image editing component shown in Figure 15 is 
similar to the interface of Adobe® Photoshop® 3.5. It will be noted that the menubar 290 
provides a separate HELP menu in addition to the HELP menu provided on the menubar 200. It 
will be appreciated that the HELP menu could be omitted from the menubar 290 and the help 
files for the database component could be accessed from the main HELP menu on the menubar 
200. It will also be noted that when the database component is invoked, the button 242 is 
grayed. Those skilled in the art will appreciate that image editing software is typically not used 
to create an image but to edit an image created by some other hardware/software such as a digital 
camera or a'scanner.' As such, there is typically a menu item for opening or capturing an image. 
As shown in Figure 15, open/capture commands may be found under the FILE menu in the 
menubar 200. Alternatively, image acquisition commands may be found under a menu item in 
the menubar 290:- ' ' 

After a user edits an image with the image editor component, the addressing and mailing 
procedure is the same as sending an ordinary email. There is no need to save a file, encode it, or 
attach it to an email message. The main email component of the invention seanilessly performs 
all of the saving, encoding, and attaching without any of this being exposed to the user. See 
Appendices A, E, and F. When the message is received by a person using a copy of the email 
program of the invention, the receiver's main email component seamlessly concatenates N41ME 
parts, decodes the MIME file, determines that it is a message created with the image editor 
cbrnponent,'invokes the image editor component, and opens the message with the image editor 
component. The receiver of the message does not have to dowrdoad any file, find any 
attachment, execute any decoders, or launch any image editor program to view/edit the image 
edited by the sender. See Apperidices A, E, and F. 

Turning now to Figure 16, when the user clicks on the button 244, the presentation (slide 
show) corriponent is invoked and it causes a new .menubar 300, a floating wizard palette 302, and . 
a blank template 304 to appear- inside the message field 2 10 of the window 208. The 
presentation component allows the author to create a slide show presentation and send it to 
another user for viewing and/or editing. Those skilled in the art will appreciate that the menubar 
300, palette 302, and template 304 shown in Figure 16 are typical of those found in a full 
featured presentation program. In fact, those skilled in the art will appreciate that the interface of 
the presentation component shown in Figure 16 is similar to the interface of Microsoft® 
PowerPoint® 98. It will be noted that the menubar 300 provides a separate HELP menu in 
addition to the HELP menu provided on the menubar 200. It will be appreciated that the HELP 
menu could be omitted from the menubar 290 and the help files for the database component 
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could be accessed from the main HELP menu on the menubar 200. It will also be noted that 
when the database component is invoked, the button 244 is grayed. , . 

After a user creates a presentation with the presentation component, the addressing and 
mailing procedure is the same as sending an ordinary email. There is no need to save a file, 
encode it, or attach it to an email message. The main email component of the invention 
seamlessly performs all of the saving, encoding, and attaching without.any of this being exposed 
to the user. See Appendices A. E, and F. When the message is received by a person using a 
copy of the email program of the invention, the receiver's main email component seamlessly 
concatenates MIME parts, decodes the MIME file, determines that it is a message created with 
the presentation component, invokes the presentation component, and opens the, message with 
the presentation component. The receiver of the message does nothave to download any file, 
find any attachment, execute any decoders, or launch any presentation program to view/edit the 
presentation created by the sender. See Appendices A, E, and F. 

As described above, messages received by the email software according to the invention 
are seamlessly decoded and displayed. Figure 17 illustrates an incoming message window 408 
which displays a message containing a combination of text and graphics in the. message field 
410. The incoming message window 408 also includes a subject field 412 and a "from:" 
address field 414 which includes information about the time the message was sent and received. 
Arrow buttons 416 allow the user to scroll through messages in the "in box". Button 418 drops 
a menu list of messages in the in box from which a message may be selected. The "+" button 
420 adds the sender's address to the recipient's address book. The rotating arrow 427 hides the 
address field 414 and expands the message field 410. Buttons 428 and 430 are not 
implemented, but may be used for public key decryption, etc. 

As mentioned above, the modular components of the invention may be authoring/reading 
components or read only components. Figure 17 illustrates an incoming message window 408 
which displays a message containing a combination of text and graphics in message field 410 
without any editing/authoring tools. The message may have been created with the word 
processing component or the painting and drawing component. The component used to create 
the message need not be known by the recipient of the message when it is opened with a read 
only component as shown. It will be appreciated that the message could also be automatically 
opened with an authoring/reading component, in which case, the message field 410 in Figure 17 
would also include a menubar, and perhaps a tool palette. According to the invenuon, the email 
client software may be provided with a full complement of read only components and the 
authoring components may be installed according to the user's choices. AdditionaUy, the email 



wo (»0/034852 



PCT/US99/29368 



.19 

client software may be programmed to automatically download a reading component from an ftp 
site when it encounters a message which requires a component which is not yet installed. 

There have been described and illustrated herein several embodiments of electronic mail 
software with modular integrated authoring/reading software components. While particular 
embodiments of the invention have been described, it is not intended that the invention be hmited 
thereto, as it is intended diat the invention be as broad in scope as the art will allow and that the 
specification be read Ukewise. Thus, while particular graphical interfaces have been disclosed, it 
will be appreciated that: other interfaces could be utilized. Also, while particular 
authoring/reading components have been shown, it will be recognized that other types of 
authoring/reading components could be provided in the spirit of the invention. Moreover, while 
particular configurations have been disclosed in reference to the code in the appendices, it will be 
appreciated that other configurations could be used as well. Further, while particular software 
code and pseudocode have been disclosed to perform various functions, it will be appreciated 
that other code and/or hardware could be utihzed to accomplish those functions and should be 
considered the equivalents thereof It will therefore be appreciated by those skilled in the art that 
yet other modifications could be made to the provided invention without deviadng from its spirit 
and scope as so claimed. 
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Appendix A: KidCcde® Lingo Client/Server Email Main Scripts 



1 on startMovie 

2 • , 

3 global emG_passwordList, emG_userGroupList, emG_userGroup, emG_userName, 

4 emG_registeredUsers. emG_msgNumber. emG_maildata, emG_mode, emG^noSLmulate, 

5 emG_mailFileList, emG_boxNanie 
6 

7 — Register the "YAK YAK" text to speech xtra . ^ , . 

8 register xtra "Yak", "XXXXXXXXXXXXX" 

9 ' •/ • 
1 0 VARIABLE LIST 

1 1 — emG_userNanie: Tracks current user by name 

1 2 emG_msgNumber: Tracks if a message is new (empty) or old (number) 
1 3 — emG_registeredUsers: Tracks users for to boxes in movies 
i 4 „. emG_passwordList: List of passwords for user logon: [password: name] 
1 5 — emG_maildata: Message data list: 

1 6 — /#to, #from, #re, #date, #mimetype, #mbxName, #msgbody , 

1 7 NOT IMPLEMENTED -> #mbxName: now takes the place of #status - eliminate 

1 8 case statement... 

19 — emG_mode: flag for message movies; #author, #display ' 

2 0 — emG_noSimulate: disable simulate Mode for message handler movies 
2 1 — emG_userGroupList: for testing rebus game 

2 2 — emG_userGroup: for testing rebus 

2 3 — emG_mailFileList: List of locations of mailfiles for each user: 
2 4 -— [unameifilename] 

2 5 — emG_boxName: a mailbox datastructure; used to pass mailboxes to the mailbox 

2 6 movie 

27 

2 8 - Install the menu 

2 9 installMenu "main menu" 
30 

3 1 -- Clear all global variables 
32 

3 3 set emG_noSimulate = TRUE 

3 4 : . . ^ . . 

3 5 — Make sure the AddUsers button is not visible ; ; . , 

3 6 set the visible of sprite 20 = FALSE . . ' • . . 

3 7 ^^ v.- r . 

3 8 initSystemUsersDataO : • i . 

3 9 initializeUserO 

40 initializePieldsO . * 

4 1 fiUStudentNameO . 
4 2 clearPasswordO - - . . - 

43 

4 4 end t 

4 5 • - 

46 

4 7 on stopMovie 

4 9 global instanceOfXtra, emGjpasswordList, emG^userGroupList, emG__userGroup, . 

5 0 emG_userName, emG_msgNumber, emG_maildata, emG_mode 
51 

5 2 -- Clear all fields and global variables 
53 

5 4 put "" into field "addPass" 

5 5 put into field "addUserGroup" 

5 6 put "" into field "addName" 

5 7 put "" into field "userList" 

5 8 put "" into field "studentName" 
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Appendix A: KidCode® Ungo Client/Server Email Main Scripts 



5 9 put into field "studentUpName" 

6 0 put into field "studentPass" 
6 1 

6 2 put into emG_userName 

6 3 set emG_msgNumber = 0 

6 4 set emG_registeredUsers = [] 

6 5 set eniG_passwordList = (:] 

6 6 set emG_userGroupList = [:] 

6 7 set emG_maildata = [:] 
68 

6 9 set emG_userGroup = 0 

7 0 set emG_mode = #empty 
71 

7 2 clear Pass wordO ' 
73 

7 4 „ empty the script used to read in mailboxes 

7 5 set the scriptText of member 65 ^ 

76 

7 7 — Make sure the AddUsers button is not visible 

7 8 set the visible of sprite 20 = FALSE 
79 

8 0 end 
81 

82 

8 3" score script 3 ss_goTheFrame 
84 

8 5 on exitFrame 
86 

8 7 go the frame 
88 

8 9 end 
90 

91 

9 2 — Modified 8-9-98. To include a mailfile location for each 

9 3 user. Added global variable emG^mailFileList. Also changed 

9 4 — format of the users file to be comma delimited items. This 

9 5 — will avoid problem with spaces in full pathnames for 

9 6 — user mailbox files. 
97 

9 8 on initSystemUsersData 

9 9 global emG_registeredUsers 

100 global emG_passwordList, emG_userGroupList, emG mailFileList 
101 

10 2 set emG_registeredUsers = [] 

10 3 set emG_passwordList = [:] 

104 set emG_userGroupList = [:] 

105 set emG_maiiFileList = [:] 
1 06 

10 7 set usersData = readUsersFile() 
1 08 

10 9 put the number of lines of usersData into totalLines 

1 1 0 repeat with i = I to totalLines 

111 

112 if line i of usersData = EMPTY then 

1 1 3 nothing 

114 else 

115 set uname = item 1 of line i of usersData 

116 set pw = item 2 of line i of usersData 
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Appendix A: KidCode® Lingo Client/Server Email Main Scripts 



117 set ugroup = value(item 3 of line i of usersData) 

118 set mfile = item 4 of line i of usersData 
119 

12 0 add emG_regisieredUsers, uname 

121 addProp emGjpasswordList, uname, pw 

122 addProp emG_userGroupList, uname, ugroup 
1 2 3 addProp emG_mailFileList, uname, mfile 

12 4 end if 
1 25 

1 2 6 end repeat 
127 

1 2 8 sortRegisteredUsersO 
1 29 

130 end initSystemUsersData 
131 

1 3 2 — ■ 

133 on initializeUser 

1 34 ' 

1 3 5 global emG_userGroup, emG_userName 

136 global emG_msgNumber, emG_maildata, emG_mode 

137 

138 put into emG_userName 

13 9 set emG_msgNumber =0 

140 set emG_maildata = [:] 

141 set emG^userGroup = 0 

142 set emG_mode = #empty 
143 

144 end initialize MyGlobais 
1 45 

146 — 

14 7" Initialize formatting of all visible text fields 

14 8" Should be called when movie starts 
149 

150 on initializeFields 

151 - 

152 " SetTextlnfo "StudentName", " "left", "arial", 14, "bold" 

1 5 3 SetTextlnfo "StudentUpName", "your usemame here ", "left", "anal", 14, "bold" 

1 5 4 SetTextlnfo "StudentPass", "left", "arial", 14, "bold" 

155 

15 6 put "" into field "addPass" 

15 7 put "" into field "addUserGroup" 

158 put"" into field "addName" ; . - 

15 9 put "" into field "userList" 
1 60 

161 " set the lineHeight of field "To" = 18 

162 set the border of member "To" = 1 

16 3 - set the border of member "ToDown" =1 
16 4 set the margin of member "ToDown" to 8 
165 

166 end initializeFields 
1 67 



169 " THIS HANDLER FILLS THE STUDENT LOGON NAME FIELD 

17 0" WITH THE CURRENT LIST OF STUDENT NAMES 

171 

1 72 on fillStudentName 

173 global emG^registeredUsers 
1 74 
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■17 5 ._ Clear the student name field for the kids' logon 

17 6 put "" & RETURN into field "studentName" 
177 

1 7 8 repeat with uname in emG_registeredUsers 
179 

18 0 put uname & ElETURN after field "studentName" 
181 

1 8 2 end repeat 
183 

18 4 -- Bring the field back to the top line 

18 5 set the scroIlTop of member "studentName" = 0 
1 86 

187 end 
1 88 

189 

19 0 — For convenience of all the message handleing movies 
191 " keep emG_registeredUsers in a special sorted order: 
19 2 " alphabetic with "administrator" at the end. 

1 93 

1 9 4 on sortRegisteredUsers 

1 9 5 global emG_registeredUsers 

1 96 

19 7 fix up emC registeredUsers in sorted order but 

19 8 -- with "administrator" at the end 
199 

2 0 0 deleteOne(emG_registeredUsers, "administrator") 
2 01 sort(emG_registeredUsers) 

2 0 2 append(emG_registeredUsers, "administrator") 
203 

2 04 end sortRegisteredUsers 

20 5 —mailbox handlers 
206 

207 — 

208 — openMailbox starts the mailbox movie 

2 0 9 — because the call must be continued in emh continue 

210 — it is necessary to use a global variable for the . 

211 — mailbox name. ' • ... : . 
212 

2 1 3 on openMbx boxName 

214 global emG_boxName 
215 

216 set emG_BoxName = boxName 
217 

218 go to frame "movie" 
219 

220 -- since all sprites are automatically puppets in Dir 6.0 

2 21 -- next should not be necessary 

222 - Take control of the sidebar buttons 
223 

2 2 4 puppetSprite 6, TRUE 

22 5 puppetSprite 7, TRUE 

2 2 6 puppetSprite 8, TRUE 

2 2 7 puppetSprite 9, TRUE 
228 

2 2 9 set mbxMovie = window "mailbox.dir" 

2 30 set the titleVisible of mbxMovie to FALSE 

2 31 set the rect of mbxMovie = getMovieRect("mailbox") 

232 
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2 3 3 open mbxMovie 

2 3 4 set the name of mbxMovie to "childWindow" 
235 

2 3 6 tell window '^childWindow'* 

2 37 - next is a hack to get around Macromedia MIA W bug 
2 3 8 see emh_continue for calls to real handlers 
2 3 9 emc_startMeUp{) 
240 

2 41 end tell 
242 

2 4 3 - CONirNUES in emh_continue 

2 44 end 

245 

246 

2 4 7 - Read mailbox accepts a string that is the mailbox name 

2 4 8 " and returns a mailbox datastructure that is the 

2 4 9 -- mailbox name and a list of the messages in that box 

25 0 ■ ' 

2 51 on readMailbox boxName 

25 2 global emG_userName, emG_mailFileList 

2 5 3 — 

2 5 4 " "inbox" : set bxstring = "#mbxName: #received" 
2 5 5 - "outbox" : set bxstring = "#mbxName: #sent" 
2 5 6 -- "savebox" : set bxstring = "#mbxName: #saved*' 
2 5 7 - "trashbox" : set bxstring = "#mbxName: #trashed" 
258 

2 5 9 set msgList = [] 

260 

261 

2 62 set mbxStruc = list(boxName, msgList) 

2 6 3 set mailFileName = getProp(emG_mailFiieList, emG_userName) 
264 

2 6 5 -- Start up Fileio Xtra 

2 6 6 set instanceOOCtra = new(xtra "fileio") 

267 

2 68 - Set up Fileio to read from users file 

269 openFile(insianceODCtra, mailFileName, 1) : , / 

270 

271 

2 7 2 "If file users doesn't exist, create it and set it up for read 

2 7 3 if status(instanceOfXtra) o 0 then 

2 74 createFile(instanceODCtra, mailFileName) 

275 openFile(instanceOfXtra, mailFileName, 1) 

276 end if 
277 

278 " Read what's currently in the file • . 
2 7 9 set whatText = readFile(instanceOfXtra) 
280 

2 81 put msgs from appropriate box into the message list 
2 82 ~ this needs to be fixed after the mail file datastructure 
28 3 "is changed.., 
284 

2 85 " if value(#mbxname)oOthen 

286 -- alert "Invalid mailbox name." 

287 -- retum(O) 
2 88 " end if 
289 

2 9 0 "OLD case statement 
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2 91 case boxname of 

29 2 "inbox*' : set bxstring = "#status: #received" 

2 9 3 "outbox" : set bxstring = "#status: #sent" 

2 9 4 "savebox" : set bxstring = "#status: #saved" 

2 9 5 "trashbox" : set bxstring = "#^status: #trashed" . . 

296 

2 9 7 otherwise: 

2 9 8 alert "Invalid mailbox name." 

2 9 9 retum(O) 

3 0 0 end case 
301 

3 0 2 - inefficient to have to look for the "#status.,. string" 

3 0 3 now is changed to value(#string) turning the string into a value, as 

3 0 4 - Director has difficuties with strings w/in property lists... 

305 

3 0 6 repeat with i = I to the number of lines in whatText 
307 

3 0 8 if line i of whatText contains bxstring then 
3 0 9 append(msgList, value(line i of whatText)) 
3 1 0 end if 
31 1 

312 end repeat 

313 

314 

315 - Close Fileio Xtra 

31 6 

3 1 7 closeFile(instanceODCtra) 
318 

319 set instanceOfXtra = 0 
320 

321 retum(mbxStruc) 
322 

32 3 end 
324 

3 2 5 on messageHandler msgStatus 
326 

32 7 global emG_userName, emG_maildata, emG_msgNumber, emO^mode, , 
328 emG_mailFileList 

329 

330 put into sendData 
331 

33 2 setProp emG_maildata, #status, msgStatus 
333 

334 

33 5 - Set up where to fmd the users mailfile 

3 3 6 set whatFile = getProp(emG_mailFileList, emG_userName) 

337 

338 

3 3 9 Start up Fileio Xtra 

340 set instanceOfXtra = new(xtra "fileio") 

341 

342 

3 4 3 Set up Fileio to read and write from/to users, file 

3 4 4 openFile(instanceOfXtra, whatFile, 0) 

345 

346 

347 - if file users doesn't exist, create it and set it up for read/write 
3 4 8 if status(instanceOO(tra) o 0 then 
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34 9 createFiIe(instanceOfXtra, whatFile) 

3 50 openFile(instanceOfXtra, whatFile, 0) 

3 51 end if 

352 

353 

3 5 4 - Read what's currently in the file 

35 5 set whatText = readFile(instanceOfXtra) : 
356 

357 

35 8 -- Add message to current user's mailbox 

3 5 9 ™ if it previously existed, then write over the old message 

360 — if not, add it to the bottom 

361 — Only messages with a status = #saved can be changed. 

36 2 

36 3 if emG_msgNumber o 0 then 

364 repeat with i = 1 to the number of lines in whatText 

3 6 5 if i = emG^msgNumber then 

366 put emG^maildata Sc RETURN after sendData 

36 7 else if line i of whatText o then 

368 put line i of whatText & RETURN after sendData 

36 9 end if 

37 0 end repeat 
371 

37 2 else if emG_msgNumber = 0 then 

37 3 put whatText into sendData 

37 4 put emG_maildata & RETURN after sendData 

375 end if 

376 

377 

3 7 8 - - Put the cursor at the begining of the users file 

37 9 setPosition(instanceODCtra, 0) 
380 

381 

38 2 " Overwrite users file with updated list 
3 83 writeString(instanceOfXtra, sendData) 
384 

385 

38 6 " Close Fileio Xtra 
387 

388 closeFile(instanceOD(tra) 
389 

3 9 0 set instanceOfXtra = 0 

391 

3 9 2 

3 9 3 "ON SEND, PUT IN OTHER CHILD'S MAILBOX, TOO 
394 

3 95 if msgStatus = #sent then 
396 

3 97 setaProp emG__maildata,#stams,#received 
398 

3 9 9 put getaProp(emG_maildata,#to) into sendingTo 
400 

401 put into sendData 

402 

403 

4 04 -- Set up where to find the users file 

40 5 - put the pathName & sendingTo into whatFile 

4 0 6 set whatFile = getProp(emG_mailFileList, sendingTo) 
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413 " Set up Fileio to read and write from/to users file 

4 1 4 openFile(mstanceOfXtra, whatFile, 0) 

41 5 
416 

417 "If file users doesn't exist, create it and set it up for read/wnte 

418 if status(instanceOfXtra) o 0 then 

4 1 9 createFile(instanceODCtra, whatFile) 

4 2 0 openFiie(instanceOfXtra, whatFile, 0) 

42 1 end if 
422 

423 

4 2 4 -- Read what's currently in the file 

42 5 set whatText = readFile(instanceOfXtra) 
426 

42 7 -- Add message to recipient's mailbox 

42 8 put emG_maildata & RETUEIN after whatText 
429 

4 3 0 - Put the cursor at the begining of the users file 

43 1 setPosition(instanceOfXtra, 0) 
432 

43 3 Overwrite users file with updated list 

4 3 4 writeStringCinstanceOfXtra, whatText) 
435 
436 

43 7 -- Close Fileio Xtra 
438 

43 9 closeFile(instanceOfXtra) 

44 0 set instanceOfXtra 0 
441 

4 42 end if 

443 

44 4 end 

445 

4 4 6 on createMailData userName, type 
447 

44 8 set newmsg = [:] 

44 9 addProp(newmsg, #to, 

45 0 addProp(newmsg, #froni, userName) 
451 addProp(newmsg, #re, "") 

45 2 addProp(newmsg, #date, the abbreviated date) 

4 5 3 addProp(newmsg, #mimetype, type) 

4 5 4 addProp(newmsg, ^status, #new) 

45 5 addProp(newmsg, #msgbody, []) 
4 5 6 retum(newmsg) 

457 

4 5 8 end createMailData 
459 

46 0 -— — 

4 61 — Make sure there is something in each of the "to" 

4 6 2 — and "from" fields and that the messagebody has the 

46 3 — right format. 
464 



407 
408 
409 
41 0 
41 1 
412 



— Start up Fileio Xtra 

set instanceOfXtra = new(xtra "fileio'*) 
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46 5 on isValidlWessage maildata 
466 

46 7 repeat with prop in [#to, #from] 

46 8 if getProp(maildata, prop) = then 

46 9 alert "But who do you wish to send this message to?" 

47 0 --retum(O) 
471 end if . 
47 2 end repeat 
473 

47 4 if not listp(getProp(mailData, ^tasgBody)) then retum(O) 
475 

476 retum(l) 
477 

47 8 end isValidMessage 
479 

480 

481 — — 

482 

48 3 onsetReply 

48 5 TAKES CARE OF SWITCHING THE SIDEBAR BUTTONS WHEN REPLY 

4 8 6 - IS HIT FROM AN OPEN MESSAGE 

487 

48 8 go to "Movie" make sure the frame is correct 
489 

49 0 " Set the buttons with reply off and send on 

4 9 1 disableReplyO 
49 2 enableSendO 
493 

494 end 
495 

496 _ 

497 

49 8 on disableSend 

49 9 go to "movie" 

50 0 puppetsprite 7, TRUE 

501 set the member of sprite 7 = member "SendNo" 

50 2 end disableSend 

503 

504 on enableSend 

50 5 go to "movie" 

506 puppetsprite 7, TRUE " 

5 07 set the member of sprite 7 = member "Send" ' - 
5 08 end enableSend 

509 ' • 

510 on disableReply 

511 go to "movie" 

5 1 2 puppetsprite 6, TRUE 

513 set the member ofsprite 6 = member "ReplyNo" . . - - 

5 1 4 end disableSend 

515 

516 on enableReply 

517 go to "movie" 

518 puppetsprite 6, TRUE 

519 set the member of sprite 6 = member "Reply" ; - 
5 2 0 end enableSend 

521 
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5 2 3 on returnToMain 
524 

52 5 global emG_msgNumber, eniG_maildata, eniG_mode 
526 

52 7 " Clear the variables * 
528 

5 2 9 set emG_msgNumber = 0 
5 3 0 set emG_maildata = [:] 
5 31 set emG_mode = #empty 
532 

5 3 3 — unpuppet the left panel buttons which reuse sprite 
5 3 4 — channels 6-9 

53 5 --MB 10-13-98 I don't like this method... it Is safer 
5 3 6 — to use new sprite channels, 

5 3 7 — is there a good reason for reusing channels... does it 

5 3 8 " affect performance? 

539 

54 0 puppetsprite 6, FALSE 
5 41 puppetsprite 7, FALSE 
54 2 puppetsprite 8, FALSE 
543 puppetsprite 9, FALSE 
544 

5 4 5 - Go back to the main menu 
546 

54 7 go to "open" 
548 

549 end 
550 

5 51 « API handlers 

552 

55 3 — emh_getUserMailbox returns the current user*s mailbox specified 
5 5 4 — by the mailBoxName parameter. 

555 

55 6 onemh_getUserMailbox mailboxName 
557 

558 retum(readMailbox(mailBoxName)) 
559 

56 0 end emh_getUserMailbox 
561 

562 

56 3 

5 6 4 on emh_getUserName 

5 65 global emG_userName . 
566 

5 6 7 retum{emG_userName) 
568 

56 9 end emh_^etUserName 
570 

571 " 

572 

5 7 3 on emhjgetUserData userName 

5 7 4 global emG userGroupList, emG mailFileList 

575 

5 7 6 retum(list (usemame, 

5 7 7 usemame, getProp(emG_userGroupList, usemame), getProp(emG_maiiFileList, 

5 7 8 userName), [], list ( "inbox", "outbox", "savebox") )) 

579 

58 0 end emhjgetUserData 
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581 
582 

58 3 - more API handlers 
584 

585 — ■ ' * 

58 6 — A curse on Macromedia. This ugly hack is used to get 

587 — around a Macromedia bug which causes the startMovie . , 

588 — handler ofaMIAW to run only after control has been 
58 9 —transferred back to the calling movie and the calling 
5 90 — movie advances a frame. 

591 

5 92 — This handler is called by the startMovie handler of the . =. 

5 93 — MIAW. This way we ensure that these scripts only run 
5 94 — after the MIAW has been properly initialized. 
595 

596 on emh_continue componentType ^ , >. ^ 

5 97 global emG_userName, emG_maildata, emG_mode, emG_boxName, emG_userOroup 

598 • 

599 - Since this function can only be called by a MIAW component . 

600 - we assume that the "childwindow" is running 
601 

60 2 if componentType = #msgHandlerthen 

60 3 tell window "childwindow" 

6 04 emc JnitWindow(emG_userName) 

60 5 msh_openMessage(emG_maildata, emG_mode) 

606 end tell 

607 

6 0 8 else if componentType = #mailbox then 

60 9 tell window "childwindow" to emcJnitWindow(emG_userName) 

610 set success = the result . , : 

6 1 1 if not success then ; i 

6 1 2 alert "Could not initialize mailbox movie" . 

613 forget window "childwindow" 

61 4 retum(O) ^ - 
615 end if 

616 

617 set mbx = readMailbox(emG_boxName) - : 

618 tell window "childwindow" to mbx_openMailbox(mbx) 

619 set success = the result 
6 20 if not success then 

6 2 1 alert "Could not open mailbox," 

62 2 forget window "childwindow" 

62 3 retum{0) "-i'-^.' . ? 

624 end if 

62 5 ^ ^ ^-^ . - . 
6 2 6 else alert "ERROR invalid componentype." 

627 

6 2 8 end emh_continue 
629 

630 • 

631 -- more API handlers 

632 — 7^ 

63 3 The emh_passMessage handler is used to pass a . message h-om . 
6 3 4 -a mailbox to the appropriate message handler 

635 ^ 

636 on emhjassMessage maildata, messageNumber ; . 
637 

6 3 8 global emG^maildata, emG_msgNumber, emG^mode . 
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639 

6 40 should check for errors in the parameters 
641 

6 42 set emG tnaildata = mailData 

6 4 3 set emG_msgNumber = messageNumber 

644 

6 4 5 If a mailbox window is open we need to close that window. 

6 4 6 -- The window will not actually close until this function completes 

6 47 and returns control to the caller function in the mailbox movie. 

6 4 8 " Therefore, we need to move it to the back so it is no longer visible. 

649 

650 moveToback window "childwindow" 

6 51 updatestage 

652 

6 5 3 tell window "childWindow" to emc _getComponentrnfo() 

6 5 4 set clnfo = the result 

6 5 5 if getComponentPr6p(cIrifo, #ComponentType) = #mailbox then 

6 5 6 tell window "childWindow" to emc_closeWindow() 

6 57 forget window "childWindow" 

658 end if 

659 

6 6 0 go to frame "movie" 

661 - set up the button bar on the left 

662 

6 6 3 set msgStatus = getProp(emG_maildata, #status) 

6 6 4 if msgStatus = ^received then -- from inbox 

6 6 5 set emG_mode = ^display 

666 disableSendO 

66 7 enableReplyO 

6 68 else if msgStatus = #sent then -- from outbox 

6 6 9 set emG_mode = #display 

67 0 disableSendO 
671 disableRepIyO 

6 7 2 else if msgStatus = #saved then — from savebox 

67 3 set emG_mode = #author 

6 74 disableReplyO 

675 enableSendO 

67 6 else — error 

67 7 alert "passing message with invalid status" 
6 78 retum(O) 

6 7 9 end if 
680 

681 — OPEN MESSAGE HANDLER MOVIE 

68 2 

6 8 3 openMsgHandler(getaProp(emG_maildata,#mimetype), emG_maildata) 
684 

6 85 end emh_passMessage 
686 

6 87 " more API handlers 
688 



6 8 9 -- THIS CODE IS BASED ON OLD STUFF WHICH USES MESSAGE NUMBER 
6 90 TO IDENTIFY MESSAGES ACROSS MAILBOXES. THIS SYSTEM 

6 91 " NEEDS TO BE CHANGED TO IDENTIFY MESSAGES BY A MAILBOXNAME 
6 92 AND A MESS AGE NUMBER WITHIN THE BOX 
693 

6 94 on emh_getMessage messageNumber, typeorBoxName 
695 

69 6 global emG_userName, emG_msgNumber, emG_mailData 
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697 

6 9 8 set emG_msgNumber = messageNumber 
699 

7 0 0 if messageNumber = 0 then return new message data 

70 1 -typeorBoxName should have mimetype . 

7 0 2 set emG_maildata = createMailData(emG_userName, typeorBoxName) 

7 0 3 retum(emG_maildata) 

7 0 4 end if 
705 

7 0 6 — otherwise find an existing message 

7 0 7 — typeorboxname should have boxName 
708 

7 0 9 set theBox = readMailbox{typeorBoxName) 

710 set emG_mailData = getat(getAt(theBox, 2), messageNumber) 

71 1 retum(emG_maildata) 
712 

7 1 3 end emh^etMessage 
714 

71 5 

716 

7 1 7 on emhjgetRegisteredUsers 

7 1 8 global emG_registeredUsers ^ 

719 

7 20 retum(emG_registeredUsers) 
721 

7 22 end emhjgetRegisteredUsers 
723 

724 

725 

7 26 on emh_killComponent 
727 

7 2 8 tell window "childwindow" to emc_closeWmdow() 

7 29 if the result = 0 then alert 'TROUBLE CLOSING WrNDOW!" 

7 30 else 

7 3 1 forget window "childwindow" 

7 32 end if 

733 retumToMainO 

734 

735 end emh_killComponent 
736 

737 

738 — Initialize formatting of text fields . ...'^ ■ 

7 39 —Thanks to Frank Leahy, maricopa site for this one.: /. : 

7 40 

7 41 on SetTextlnfo fldName, fldValue, fIdAlign, fldFont, fldSize, fldStyle 
742 

7 4 3 put fldValue into field fldName 

7 4 4 set the textAlign of field fidName = fldAlign 

7 4 5 set the textFont of field fldName = "arial" -fidFont 

7 4 6 set the textSize of field fldName = fldSize 

7 4 7 set the textStyle of field fldName = fldStyle 

748 

7 49 end 
750 

751 — 

752 

7 5 3 " script of cast member studentName 

7 54 — emG_userName should not be set here 
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75 5 ~ because it could be invalid 
756 

7 5 7 on mouseUp 
758 

7 5 9 - Put selected user name into up version of student field 

760 - switch the field from down to up 

761 

76 2 put word I of Une(the mouseLine) of field "studentName" into field "studentUpName" 
763 

7 6 4 set the member of sprite 14 to member "StudentUpName" 
765 

7 6 6 end 

767 ^ 
768 

7 6 9 - script of cast member studentUpName 
770 

77 1 on mouseUp 
772 

7 7 3 - Pull down student field: change field from 
77 4 - up (sprite 17) to down (sprite 16) 
775 

7 7 6 set the member of sprite 14 to member "StudentName" 
777 

7 7 8 -- clear password field 

77 9 clearPasswordO 
780 

781 end 

78 2 

78 3 

784 



7 8 5 — scripts of cast member studentPassword 

786 

787 

78 8 onkeyUp 

7 8 9 global gpw, gpwien 

7 9 0 "gpw is global password and 

7 9 1 "gpwien is global password length 

792 

79 3 hideAiertO - user maybe trying again. ..hide badPwMsg 
794 

7 9 5 if the key = RETURN then 

7 9 6 if checkPassword(field "studentUpName", gpw) then 

79 7 enterMainEmai!(field "StudentUpName") 

7 9 8 else — invalid password 

79 9 alertBadPasswordQ ' ^ * ' 

800 end if 

801 setgpw = "" 

802 set gpwien = 0 

80 3 put "" into field "studentPass" - reset the password field 
804 end if 

805 

80 6 endkeyUp 
807 

808 

809 

810 on keyDown 

8 1 1 global gpwien, gpw 
812 
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8 1 3 -eats the key, otherwise it will appear until keyup 
814 

815 if the key = BACKSPACE then 

816 put into char gpwien of field "studentPass" 

817 put into char gpwien of gpw 

818 if gpwien > 0 then 

819 set gpwien = gpwien - l 
8 2 0 end if 

8 2 1 else if the key = RETURN then 
82 2 nothing 

8 2 3 else if the keycode >= 1 17 and the keycode <= 126 then 
8 2 4 nothing 
8 2 5 else 

82 6 put after field "studentPass" 
82 7 put the key after gpw 

82 8 set gpwien = gpwien + 1 
829 

830 end if 
831 

8 32 set the selstart = gpwien 
8 3 3 set the selend = the selstart 
834 

83 5 endkeyDown 
836 

837 

8 38 script of cast member goStudentLog 
839 

84 0 on mouseUp 
841 

8 4 2 go to frame "pass" 
843 

844 end 

845 

846 

84 7 script of cast member editUsers 
848 

84 9 on mouseUp 
850 

851 " set the default pathname for the mail file location ^ 
8 5 2 put the pathname into field "addMailFileLoc" 
853 

854 go to frame "edit" 

855 . 

856 end ' ' 
857 

858 

859 - script of cast member okUser 

860 

861 

8 62 on mouseDown 

863 set the member of sprite 7 = "okay down" 

864 end 
865 
866 
867 

868 - script of cast member okDown 

869 

870 
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8 71 on mouseUp 

8 7 2 global gpw, gpwlen — see script of field studentPass 
873 

8 7 4 set the member of sprite 7 = "okayUser" 
875 

8 7 6 if checkPassword( field "studentUpName", gpw) then 

8 7 7 — valid user & pw 

8 7 8 enterMainEniail(field "studentUpName'*) 

879 

8 8 0 else password invalid 
881 

8 8 2 alertBadPasswordO 
883 

8 8 4 end if 
885 

886 clearPasswordO 
887 

88 8 end 

8 8 9 -- script of cast member addUser 
890 

8 91 on mouseUp 

8 9 2 global emG_registeredUsers 

8 9 3 global emG_passwordList, emG_userGroupList, emG_mailFileList 
894 

8 9 5 -check that usemame is filled and is unique 
896 

8 9 7 if field "addName" = EMPTY then 

8 9 8 alert "No usemame" 

8 9 9 retum(O) 

90 0 else if getOne(emG_registeredUsers, field "addName") then 

901 alert "Usemame akeady in system. Choose a different name'* 

90 2 retum(O) 
903 

9 0 4 else set uname = field "addName" 
905 

90 6 "NEED TO TAKE CARE OF THIS!!!! 

907 - check that the mailfile location is a valid directory 

90 8 " there are serious problems with this at present 
909 — for now assume pathnames are valid 

910 

91 1 

912 - add new User data to system global variables 

913 add(emG_registeredUsers, uname) 

9,1 4 addProp(emGj3asswordList, uname, field "addPass") 

9 1 5 addProp(emG_userGroupList, uname, field "addUserGroup") 

916 append usemame to the mailfile location directory 

9 1 7 addProp(emG_mailFileList, uname, field "addMailFileLoc" & uname). . 

918 

9 1 9 sortRegisteredUsersO 
920 

9 21 - write the users file with system users data 

9 2 2 writeUsersFileO 

923 

92 4 " Put the updated user list into the userList field 
9 2 5 put "" into field "userList" 

9 2 6 repeat with uname in emG_registeredUsers 

9 2 7 put uname after field "userList" 

9 2 8 put " " & getProp(emG_passwordList, uname) after field "userList" 
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9 2 9 put " " 8l getProp(emG_userGroupList, uname) after field "userList" 

9 3 0 put *' " & getProp(emG_mailFileList, uname) after field "userList" 

9 31 put RETURN after field "userList" 

9 3 2 end repeat 

933 

934 

9 3 5 — reset the User data fields 
936 

9 3 7 put into field "addUserGroup" 

9 3 8 put into field "addPass" 

9 3 9 put into field "addName" 

94 0 put the pathname into field "addMailFileLoc** 

941 

9 4 2 Refill the kids' logon name field 

9 4 3 fillStudentNameO 

944 

945 end 
946 

947 — script of cast member seeUserList 
948 

94 9 on mouseUp 
950 

951 global instanceOfXtra 

952 

953 

95 4 put into field "userList" 
955 

956 

95 7 " Set up where to fmd the users file 

95 8 put the pathName & "users" into whatFile 
959 

960 

961 Start up Fileio Xtra 

96 2 set instanceOfXtra = new(xtra "fileio") : 
963 

964 

96 5 " Set up Fileio to read from users file 
966 openFile(instanceOfXtra, whatFile, 1) 
967 

96 9 If file users doesn't exist, create it and set it up for read to. avoid error 
970 

971 if status(instanceOfXtra) o I then 
9 7 2 createFile(instanceODCtra, whatFile) 

97 3 openFile(instanceOfXtra, whatFile, 1) 

974 end if . - 

975 

976 

9 7 7 Read what's currently in the file 

9 78 set whatText = readFile(instanceOfXtra) 

979 

980 

9 81 "Put the updated user list into the userList field 

9 8 2 put whatText into field "userList" 

983 

984 " Close Fileio Xtra 

9 8 5 closeFile(instanceOfXtra) • 

986 
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987 set instanceOfXtra = 0 
988 

98 9 end 
990 
991 
992 

99 3 - script of cast member DoneAdmin 
994 

9 95 on mouseUp 
996 

9 9 7 go to frame "open" 
998 

9 9 9 put into field "addName" 

1000 put into field "addUserGroup" 

1001 put into field "addPass" 

1002 put into field "addMailFileLoc" 
1003 

1004 end 

1005 — rasgHandlers scripts 

1006 — 

1007 — openMsgHandler starts the appropriate Message Handling movie. 
10 08 — The call must be continued in emh_continue. 

1009 — It is necessary that the global variable emG_mailData is 

1010 — set up. Therefore, we pass it as a parameter to make it 

1011 — clear that the variable is necessary. 
1012 

1013 on openMsgHandler mimetype, mailData 
1014 

1015 set movieName = getMessageHandler(mimetype) 

1016 go to frame "movie" 
1017 

1018 since all sprites are automatically puppets in Dir 6.0 

1019 " next should not be necessary 

10 20 - Take control of the sidebar buttons 
1021 

10 22 puppetSprite 6, TRUE 
10 23 puppetSprite 7, TRUE 
10 2 4 puppetSprite 8, TRUE 

10 2 5 puppetSprite 9, TRUE 
1026 

10 27 set mshMovie = window movieName 

10 28 set the titleVisible of mshMovie to FALSE 

10 2 9 set the rect of mshMovie = getMovieRect(mimetype). 

1030 

1031 open mshMovie 

10 3 2 set the name of mshMovie to "childWindow" 
1033 

10 3 4 tell window "childWindow" 

10 3 5 " next is a hack to get around Macromedia MIAW bug 
10 36 " see emh_continue for calls to real handlers 
10 3 7 emc_startMeUp() 
1038 

1039 end tell 
1040 

10 41 -- CONTRsHJES in emh_continue 
1042 end openMsgHandler 
1 043 
1044 
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1046 - getMessageHandler returns filename of movie to handle mimetype. 

1047 - This code makes it easy to make changes in movie filenames 

1048 and to add new message handling movies. 
1049 

1050 on getMessageHandler mimetype 
1051 

1052 case mimetype of 

1053 "text": retumCtext.dir*') 
10 54 "rebus": retum("rebus.dLr") 
10 55 "grid": retum("grid-dir") 

1 0 56 "connect": retumC'connect.dir") 

1 057 "puzzle" : retum("puzzle.dir") 
1058 

1 059 otherwise: 

10 60 alert "Invalid mimetype of message." 

1061 retum("") 

10 62 end case 
1063 

1064 end getMessageHandler 

1065 

1066 

1067 on getMovieRect whichMovie 



1068 

10 6 9 — the top of green panel 

107 0 set movieTop = the top of sprite 3 

1071 — the left of green panel 

10 7 2 set movieLeft = the left of sprite 3 

1073 

107 4 case whichMovie of 

10 75 "rebus", "rebus.dir": 

10 7 6 set theRect= rect(movieLeft, movieTop, - 

107 7 movieLeft + 640, movieTop +480) 

1078 "text", "text.dir": 

107 9 set theRect= rect(movieLeft, movieTop, 

1080 the stageRight - 5, the stageBottom -5) 

1081 "puzzle", "puzzle.dir": 

108 2 set theRect= rect(movieLeft, movieTop, ^ 

-1083 the StageRight - 5, the stageBottom -5) 

1084 "grid", "grid.dir", "connect", "connect.dir": 

1085 set theRect= rect(movieLeft, movieTop, ^ 

1086 the StageRight - 5, the stageBottom -5) 

1087 "mailbox", "mailbox.dir": 

1088 set theRect= rect(movieLeft, movieTop, ~^ 

1089 the StageRight - 5, the stageBottom -5) ; . 
10 90 otherwise: 

1091 alert "ERROR: invalid movieName: " & whichMovie 

1092 set theRect = rect(O,O,O,0) 



1093 

1094 end case 
1 095 

1096 retum(theRect) 
1097 

10 98 end getMovieRect 
1 099 
1 100 
1101 

1102 score script frJnstallMenu 
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1 103 

1104 on prepareFrame ^ 
110 5 —first clear away any old menus 

1106 installMenu 0 

1107 installMenu "main menu" 
1 1 08 end 

1109 

1 1 1 0 — ' ~~ 

1111 -- password verification and user init 

1112 

1113 

1114 

1115 on enterMainEmail username 

1116 global emG_userName, emG_user<}roup, emG_userGroupList 
1117 

1118 set emG_userName = username 

1119 set emG_userGroup = getProp(emG_userGroupList, emG_userName) 
1 1 20 

1121 - ADMINISTRATOR has access to the "Edit Users*' button 
112 2 if emG_userName = "administrator" then 
112 3 set the visible of sprite 20 = TRUE 
1124 end if 
1 1 25 

1126 go to frame "open" 
1127 

112 8 end enterMainEmail 
1129 

1 1 30 

1131 
1132 

1133 on checkUserName userName 

113 4 global emG_registeredUsers 
1135 

1136 ifgetone(emG_registeredUsers, userName) then 

1137 retum(l) — username is in system 
1 1 38 

113 9 else 

1140 alert "User " & userName & "not a KidCode authorized user." & RETURN & "You 

1141 cannot login without a valid username." ' . 
1 142 

1 1 43 end if 
1 1 44 

1145 end checkUsemame 
1 1 46 

1147 more password handling scripts , , 

1148 

1149 on checkPassword userName, password 

115 0 global emG_passwordList , 
1151 

1152 "if the username is not valid quit this... 
115 3 if not checkUserName(userName) then retum(O) 
1154 

115 5 — username is valid 
1156 

115 7 First part of loop changes capital letters to lower case 
115 8 - Second part puts lower case letters into password check 
115 9 -- This eliminates all spaces and/or unacceptable characters 
1160 
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1161 set checkPassword = 

1162 repeat with i = 1 to the number of chars in password 
1163 

1164 put char(i) of password into capital 

1165 put charToNum(capiial) into capital 
1 1 66 

1167 if capital <= 90 and capital >= 65 then 

1168 put numToChar(capital + 32) after checkPassword 

1169 else ifcapital>== 97 and capitaK- 122 then 

1170 put numToChar(capital) after checkPassword 

1171 end if 
1172 

117 3 end repeat 
1174 

1175 - CHECK PASSWORD 

1176 : ■ 
117 7 set realPassword = getProp(emG jDasswordList, usemame) 

1178 

1179 if realpassword = checkPassword then 
1 1 80 retum(l) -TRUE 

1181 else 

1182 retum(O) 

1183 end if 
1 1 84 

1 1 85 

1186 end checkPassword 
1 1 87 

1188 

1 1 89 

1190 on clearPassword 

1191 global gpw, gpwlen 
1192 

1193. set gpw = 

1194 set gpwlen = 0 /. 

1195 put into field "StudentPass" 
1196 

1197 end clearPassword 
1198 

1199 

1 200 

1201 on alertBadPassword 
1 202 

1 20 3 set the loc of sprite 1 7 to point(23 1 , 350) 

1 204 beepO ^ 

1205 

1 206 end alertBadPassword 
12 07 on hide Alert 
1 208 

1 2 09 set the loc of sprite 1 7 to point(- 188,-31) 
1210 

1211 end hideAlert 

1212 

1213 

1214 script of cast member reply 
1215 

1216 on mouseUp 

1217 global emG_userName, emG_msgNumber 

1218 global emG_maildata, emG_mode, emG_userGroup 
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1219 

1220 - abandon current MailData which should be in the inbox, 

1221 Later, the user may choose to either abandon or send 
1 2 2 2 "the new replyTo message. That is not a concern. 
1223 

12 24 "[fa mailbox window is open need to get the message 

1 2 2 5 " and close that window. 
1 226 

122 7 teil window "childWindow" to emc_getComponentInfo() 

1 2 2 8 set clnfo = the result 

1 2 2 9 if getComponentProp(cInfo, #ComponentType) = ^mailbox then 

1 2 30 tell window "childwindow" to mbx_GetMessageNumber() 

1231 set emG_msgNumber = the result 

1 2 3 2 if emG_msgNumber <= 0 then 

1 2 3 3 alert "You must select a message." 

1 2 3 4 retumO - abandon the request to reply 

1 2 35 end if 

1 236 

12 3 7 tell window "childwindow" to mbx_GetMessage(emG_msgNumber) 

1 2 38 set emG_maildata = the result 
1 239 

1 2 40 — forget window "childwindow" - done in passMessage 
1241 

1 2 42 — Now open the appropriate Message Handler 

1 2 43 — to display the message 
1 244 

1 2 45 emh_PassMessage(emG_maildata, emG_msgNumber) 
1 246 

1 2 47 end if 
1 248 

1 2 4 9 - If we got to this point message handler is open. 

1 2 5 0 " Presumably it has a message displayed. If the message 

12 51 "is empty only the message handler knows that and it 

12 5 2 " will need to catch the error and return an error code 

1 2 5 3 "to msh_replyMessage. 
1 254 

1 2 5 5 " The message handling movie's replyMessage handler 

1 2 5 6 " should swap "to" and "from" 

1 25 7 " fields and make the message editable 

1 258 

1 2 5 9 -set mode to author to keep it consistent with msg handler 

1260 set emG_mode ^ ^author 

1261 

1 262 set emG_msgNumber = 0 - this is now a new message 
1 263 

1 26 4 tell window "childWindow" 

126 5 global emG_userGroup 

1 26 6 " msg handler will swap "to" with "from" and change 

1267 mode to author 

1268 moveToFront window "childWindow" 
12 6 9 msh_replyMessage() 

1270 end tell 
1271 

1 2 7 2 set emG_maildata = the result 
1273 

12 7 4 " Toggle the send and reply buttons 

127 5 setreply -- disable reply and enable send buttons 
1276 
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1277 

1 278 end 

1279 

1280 

1281 — script of cast member send 
1 282 

1 2 83 on mouseUp 

1 284 global emG_maiIdata, einG_userGroup 
1285 

1 286 " Could check that the childwindow is a messagehandler 
1 287 --but this may not be necessary. 
1 288 

1289 tell window "childWindow" 

1 2 90 global emG_userGroup 

1291 msh_sendMessage() 

1 292 set emG_maildata = the result 

1 293 end tell 

1 294 

1 2 95 if not isVaHdMessage(emG_maildata) then 
1 2 96 alert "ERROR not a valid message." 
1 297 retum(O) - abandon attempt to send 
1 2 98 end if 
1 299 

1 300 — otherwise continue to send message 

1 302 - NEED TO FIX THIS SO THAT MESSAGE STATUS DOES NOT 
1 303 BECOME "#sent" if it fails to be saved to both 
1 304 " mail files 
1305 

1 306 messageHandler(#sent) - for now this uses global emG_maildata 
1307 

1 308 tell window "childWindow" to msh_clearMessage() 

1 309 

1 310 end 

1311 

1312 - script of cast member print 
1313 

1314 on mouseUp 

1316 tell window "childwindow** to emc_getComponentInfo() 

1317 set cinfo = the result . - 

1318 set cType = getComponentProp(cInfo, #ComponentType) 
1319 

1 320 if cTy pe = #mailbox then 

1 321 need to pass the message to its message handling ; : 
1 32 2 component for printing. Ideally this can be done 
1 32 3 -- without opening a window and laying out the message. 
1 324 

1 32 5 alert "1 can't do that right now. Open the message and then print. 
1326 

1 327 else if cType = #msgHandler then 
1 328 

1 329 tell window "childwindow" 
1 330 msh_PrintMessage() 
1 331 end tell 
1 332 

1 333 else alert "ERROR invalid componentype." 
1334 
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1 3 35 end 
1 336 

1 3 37- — 

1 3 38 -- script of cast member Quit 
1 339 

1 3 40 on mouseUp 
1 341 

13 42 handleQuitO 

1 343 

1 344 end 

1 345 

1 3 46— — — 

1 347 

1 348 on handleQuit 
1 349 

1 3 5 0 LnitializeUserO 
13 51 clearPasswordO 
1 3 5 2 go to frame 2 
1 353 

1 3 5 4 make sure the editUsers button is invisible 
1 3 5 5 set the visible of sprite 20 = FALSE 
1356 

1 3 5 7 end handleQuit 
1358 

1 3 5 9 — script of cast member trash 
1 360 

1361 ™ Email Main now handles all aspects of trashing a 
1 3 6 2 — message by writing the mail files. The components 
1 3 6 3 — are instructed to update their state by clearing the 
1 3 6 4 — message (if the component is a message handler) or 
1 36 5 — redrawing the message list (if the componerit is a 
1 36 6 — mailbox.) 
1 367 

1 36 8 — Should add a confirmation dialog with the user 
1 369 

1370 on mouseUp 

1371 global emG_msgNumber -- number of the current message 
1 372 

13 7 3 tell window "childwindow" to emc_getComponentInfo() 
1 3 7 4 set cinfo = the result 

137 5 set cType = getComponentProp(cInfo, #ComponentType) 
1 376 
1 377 

1 378 if cType = #mailbox then 

137 9 " need to determine which message(s) are currently 
1 3 80 selected and instruct the mailbox to update its, 
1381 - display 
1382 

1383 - temporary implementation of mbx/_trashMessages does 

1384 -not handle multiple messages as a result the 
1 38 5 arguments are ignore... 

1386 

1387 tell window "childwindow" to mbx_trashMessages([]) 
1 388 

1389 — the following lines will be neceessary when 

1390 -- mbx_trashMessages is properly implemented. For 

1391 " now, the temporary implementation trashes the . 
13 9 2 — message itself 
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1 39 3 - set messageN umbers = the result 

1 394 " delete each message in the list of messageN umbers 

1 395 

1 396 

1 397 else if cType = #msgHandler then 
1 398 

13 99 rewrite the message into the mailfile 

1400 messageHandler(#trash) ' 

1401 

1402 tell window "childwindow" to msh_clearMessage() 
1 403 

1404 else alert "ERROR invalid componentype." 

1405 

1 406 

1407 end 

1408 

1409 

-j 4 1 0 — script of cast member text 

141 1 

1412 on mouseUp 

1413 global emG_msgNumber 

1414 global emG_maildata, emG__mode 
1415 

1416 START A NEW MESSAGE 
1417 

1418 set emG_msgNumber = 0 

1419 set emG_niode =^ #author 

1420 set emG_maildata = createMailData(emG_userName, "text") 
1421 

1422 openMsgHandlerC'text", emG_mailData) 
1423 

142 4 disableReplyO 
1425 

1426 end 
1 427 

1 428 

142 9 script of cast member Rebus 
1 430 

1431 on mouseUp 

1432 global emG_msgN umber 

143 3 global emG_maildata» emG_mode 
1434 

1435 - START A NEW MESSAGE 
1 436 

1437 set emG_msgNumber = 0 

1438 set emG_mode = #author 

1439 set emG_maildata = createMailData(emG_userName, "rebus") 
1 440 

1441 openMsgHandlerC'rebus", emG_mailData) 
1442 

1 44 3 disableReplyO 

1 444 

1445 end 

1 446 

1447 

1448 — script of cast member grid 
1 449 

145 0 on mouseUp 
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1451 global emG_msgN umber 

1452 global emG^maildata, emG_mode 
1453 

1454 - START A NEW MESSAGE 
1455 

14 5 6 set emG_msgNumber = 0 
14 5 7 set emG_mode = #author 

14 58 set emG_maildata = createMailData(emG_userName, "grid") 
1459 

146 0 openMsgHandler("grid", emG_mailData) 
1461 

1 46 2 disableReplyO 

1463 

1464 end 

1 465 

1466 

1467 —script of cast member puzzle 
1468 

146 9 onmouseUp 

147 0 global emG_msgNumber 

1471 global emG_maiIdata, emG_mode 
1 472 

1473 START A NEW MESSAGE 
147 4 

14 7 5 set emG_msgNumber = 0 
147 6 set emG_mode = #author 

147 7 set emG_maildata = createMailData(emG_userName, "puzzle") 
1478 

147 9 openMsgHandler("puzzle", emG_mailData) 
1 480 

1 481 disableReplyO 

1482 

1483 end 

1484 

1485 

148 6 — script of cast member connect 
1487 

1488 onmouseUp 

148 9 global emG_msgNumber 

149 0 global emG maildata, emG mode 
1491 

149 2 - START A NEW MESSAGE 
1493 

149 4 set emG msgNumber = 0 

149 5 set emG_mode = #author 

1496 set emG_maildata = create Mai lData(emG_userName, "connect") 
1497 

14 9 8 openMsgHandler("connect", emG_mailData) 
1499 

15 0 0 disableReplyO 
1501 

150 2 end 
1503 

1 5 04 — 

150 5 on getComponentProp infoLlst, prop 
1506 

1507 — need to add error checking code 
1508 
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1509 case prop of 

1510 #componentName: retuni(getAt(infolist, 1)) 

1511 #componentID: retum(getAt(infolist, 2)) 

1512 #componentType: retum(getAt(infolist, 3)) ' 

1513 #componentM[N4Etype: retum(getAt(infolist, 4)) 
1514 

1515 otherwise: alert "ERROR no component property." 

1516 end case 
1517 

1518 end getComponentProp 
1519 

1520 - script of cast member savebox 
1521 

152 2 on mouseUp 
1523 

1524 openMbx("savebox") 

1525 

1526 end 

1527 

1528 

1529 --script of cast member inbox 
1530 

15 31 on mouseUp 
1532 

15 3 3 openMbx("inbox") 

1534 

15 35 end 

1536 

1537 

1538 

15 39 ~ script of cast member outbox 
1540 

15 41 on mouseUp 
1542 

15 43 openMbx("outbox") 

1544 

1545 end 

1546 

1547 

15 48 — Users File functions 
1549 

15 50 -- returns a string of ail users data from the users file. 
■1551 

15 52 - THIS FUNCTION NEEDS TO CHECK THAT DATA IS VALID 
15 53. ■ ■ 

15 54 on readUsersFile 
1555 

15 5 6 — Set up where to find the users file 
1557 put the pathName & "users" into whatFile 
1558 

155 9 - Start up Fileio Xtra 

15 60 set instanceOfXtra = new(xtra "fileio") 

1561 

15 62 —Set up Fileio to read from users file 
1563 openFile(instanceOfXtra, whatFile, 1 ) 
1564 
1565 

1566 - If file users doesn't exist, create it 
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1567 

15 68 if status(instanceO£Xtra) o 0 then 

1569 createFile(instanceOfXtra, whatFile) 

1570 openFile(insianceOfXtra, whatFile, 1) 

1571 end if 
1 572 
1573 

15 74 -- Read what's currently in the file 

1 5 75 set whatText = readFile(instanceOfXtra) 

1576 

1 577 

1578 -ifno users are defined, assume administrator as default user 

15 7 9 Administrator info is not written into the user's file until at 

1580 " least one user is defined. This occurs in AddUsers functions. 
1 581 

15 8 2 if whatText = then 

15 83 - for now, assume admin has mail file in each 

158 4 " location where kidcode is installed 

1585 put "administrator,kidcode,0," & the pathName & "administrator" & RETURN into 

1586 whatText 

1587 end if 
1588 

1589 - Close Fileio Xtra 

15 90 closeFile(instanceOfXtTa) 

15 91 set instanceOfXtra = 0 
1 592 

15 93 retum(whatText) string read from users file 
1594 

1 5 9 5 end readUsersFile 

1596 

1597 

1598 

15 99 more users file scripts 
1600 

1601 on writeUsersFile 

160 2 global emG_registeredUsers, emG_passwordList, emG_userGroupList, 

160 3 emG_mailFileList 
1 604 

160 5 "Set up where to find the users file 

160 6 put the pathName & "users" into whatFile : 
1607 

1608 -- Start up Fileio Xtra 

16 09 set instanceOfXtra = new(xtra "fileio") 

1610 . .i : • 

1611 - Set up Fileio to read and write from/to users file 

1612 openFiIe(instanceO€Xtra, whatFile, 0) - : 
1613 

1614 "If file users doesn't exist, create it and set it up for read/write 
1615 

1616 if status(instanceOfXtra) o 0 then 

1617 createFile(instanceOfXtra, whatFile) 

1618 openFile(instanceOfXtra, whatFile, 0) 

1619 end if 
1620 

16 21 "Put the cursor at the begining of the users file 

16 2 2 setPosition(instanceOfXtra, 0) 
1 623 

162 4 — put together string of usersData 
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162 5 set whatText = 

16 2 6 repeat with uname in emG_registeredUsers 
1627 

16 2 8 set pw = getProp{emG_passwordList, uname) 
16 2 9 set ugroup = getProp(emG_u3erGroupList, uname) 

163 0 set mfile - getProp(emG_mailFileList, uname) „ „ « ^. o 

1631 set whatText = whatText & uname & & pw & & ugroup & , & mfile & 

1632 RETURN 
1633 

16 3 4 end repeat 
1635 

16 36 " Overwrite users file with updated list 

163 7 writeStrmg(instanceO£Xtra, whatText) 
1638 

1639 - Close Fileio Xtra 
1640 

1641 closeFile(instanceOfXtra) 
1642 

164 3 set instanceOfXtra = 0 
1644 retum(l) 

1645 

16 46 end writeUsersFile 
1647 

1648 

164 9 these next functions are created to do file checking 

165 0 — however they appear to suffer from severe crash problems 
1651 — these problems will also effect mail file creation if 

16 5 2 — path names are invalid.. .we need to fix this 
1653 

16 54 on pathp pathname 
1655 

16 5 6 set instanceODCtra = new(xtra 'Tileio") 
16 5 7 openFile(instanceOfXtra, pathname, 1) 
16 5 8 set theval - status(instanceofKtra) 
1659 

16 6 0 case theval of 
1661 0: 

16 6 2 closeFile(instanceOfXtra) 
16 6 3 set instanceOfXtra = 0 

166 4 retum(l) 
1 665 

16 6 6 -36: - I/O Error. .likely to cause system crash 

166 7 . alert "System has become unstable. " & RETURN & "Please save your work." 
1668 next call to fileio xtra may crash system 

166 9 set instanceOfXtra = 0 

167 0 retum(O) 
1671 

167 2 otherwise : 

167 3 alert " " & error(instanceOfXtra, theval) 

167 4 closeFile(instanceOfXtra) 

1675 set instanceOfXtra = 0 

16 7 6 retum(O) 

1677 

167 8 end case 
1679 

168 0 end pathExists 
1681 

1682 
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1683 on foldertest 

1684 getNthPileNameInFolderC'C:\windows", 1) 

1685 end foldertest 
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KidCode® Application Programming Interface (API) 

This API defines the data and function calls that are used for communication between the 
KidCode Main Email program and installable components., Each mstallable component 
can be one of two types: . . . / - 

• mailbox browser/editor component . 

• message authoring/display component 

KidCode Main Email application may communicate with another mail server such as an 
SMTP compliant server to retrieve and store email messages.. Alternatively, the Emajl 
Main program may include code for many of the functions normally associated with a 
mail server program. Whether in conjunction with a mail server, or on its own, the Email 
Main program handles all functions associated with sending and receiving email 
messages. This includes reading and writing mailbox files to/from permanent storage or 
other mail servers on a network (e.g. using POP3), finding and verifying network 
addresses,, and sending mail messages to other servers on a network. 

The Main Email Program also provides a GUI that provides interaction with a user for 
those functions that are directly associated with storage and transfer of electronic mail 
messages and mailboxes. In particular, the Main Email program includes buttons and/or 
menu items that allow a user to: 

• Send (a message), 

• Reply (to a message), 

• Open (a message or a mailbox), . , 

• Delete/Trash (messages or mailboxes), 

' • Save (a message to an alternative mailbox) - - 

• Print (a message) 

The Main Email Program also handles all data bundling and unbundling that may be 
required to transform the message data used by a message authoring component into a 
fully MIME compliant message type. This way each message authoring component can 
handle data in a format most convenient to it and all MIME parsing and details associated 
with protocol compliance can be centralized in the Main Email application. The only 
requirement for the message data passed between a message authoring component and the 
Main Email Program is that the message body data be formatted either as an ASCII string 
or in a binhex format. 

The KidCode Main Email program communicates with installable cbmponertts in order to 
execute the commands defined above. ' ^ ; 

Mailbox browser/editor components \ 

Mailbox components are used to display, edit, and browse mailboxes. Different kinds ot 
users and different types of messaging applications (e.g. fax, traditional email, internet 
voice) may require very different displays and functionality from a^'mailbox viewer/editor. 
Installable mailbox components make it possible to upgrade, select from multiple viewing 
formats, utilize different mailbox viewer/editors for different users, and in general increase 
the range of functionality that can be achieved within one basic messaging application 
program. 

Message authoring/display components 

Message handler components make it possible to handle an unlimited number of message 
types. Each message handler component is designed to deal with a specific MIME type 
of message. The MIME data standard has been designed so that application developers 
can define new MIME types as needed by labeling these with the *7application-x" prefix. 
A message handler component can be any program that defines a message MIME type of 
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data that it handles and that implements the callback entry points described m this 
document. These functions allow the Main Email application to obtain information about 
the message handler and allows the message handler to respond to standard mail 
commands such as Send or Reply, that have been issued by a user through the Main 
Email interface. Example message handler components included in the KidCode 
application are an ordinary ascii text message handler, a game called Rebus that allows 
users to create and respond to graphical rebus messages, an a sample mathematics 
workbook that allows students and a teacher to send workbook problems to one another. 

Global variable naming conventions: 

Each movie should name its global variables with a prefix that identifies the movie and a 
capital "G" for "globar*. We will keep track of each movie's prefix. For now we have the 
following idehtifing prefixes: 









em_ 


main movie 


emG_ 


tm_ 


text movie 


tmG„ 


nTi_ 


rebus movie 


rmG_ 


cm_ 


connect movie 


cmG_ 


tgm_ 


text grid movie 


tgmG_ 


pm_ 


puzzle movie 


pmG_ 


mbx_ 


mailbox movie 


mbxG_ 



Main Movie Public Data Types 

• emj.ComponentType : symbol = #mailbox or #msgHandler 
em_UserName string 

em_UserData struct ( 

str UserName 
str FullName 
str RetumAddress 
. . em_AddressBppk . . Add^essBook . 
em_MailboxList . Mailboxes, 
str . - : .; iSMTPHost 
str . . : :P0P3Hpst/ 
. str Password 

) - ■ ■: \ . ' ^ 

em_MailboxName string 

em_Mailbox struct ( 

' em„mailboxName boxName 
list of emMailData 

em_RegisteredUsers list of em_UserName 
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em.MailData struct ( 

em.Address To 

em_Address From 

str Re 

str Data 

str MimeType 

list MsgBody ■ ; — 

em„MessageNumber int 

em_Mode symbol = #author or #display 

em_ComponentInfo struct ( 

str ComponentName 

int ComponentID 
em ComponentType ^^"^PonentType _ 

^ str ComponentMIMEType ; ml if mailbox 

) 

Email Main API Functions 

These functions are called by the installable components to access services provided in the 
KidCode Main Email program. 

1 ********************************************* *^ 

* * ** / 

Rem^lfSlilto^di^Tstructure for the current user and mailbox name. This function is 
normally called by a mailbox handling component. , Mailbox handling coroponents. may 
use temporary files to hold mailbox contents but they should never access the, users 
mailbox files. All access to these files must be obtained through the Mam Email 
program. . . r . , , 

*/ 

em_Maiibox emh_getUserMailbox ( ; . - 

em_MailBoxName 

) -.^ - ■■ . 

c*********************** *********************************** 

* * * * . ^ . . ... 

/* emh eetUserData . ^ 

Return a data structure with user information. The KidCode Mam Email P^pg^am 

maintains all user information and handles user administration functions. The^Main 

program also communication with external Mail servers which may contain other user 

information not part of the KidCode API. 

*/ 

em_UserData emh_getUserData ( 

" em^UserName, ' 
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* * * * / 

/* emh„continue . • rr i 

Used by installable components to explicitly pass control back to the Main bmail 
program. This function is necessary for the Director/Lingo implementation. 

*/ 

void emh_continue ( 

em_ComponentType 

) 

c ************************ ***************** 

****y 

/* emh_killComponent ^ • ■ 

Used by an installable component to inform the Main Email program that it is preparing 

to terminate. This allows the Main program to free any memory and/or data structures that 

have been allocated to the component. 

*/ 

void emh_.killComponent ( 

) 

1********************************************************** 

* * * * / 

/* emh_passMessage ' ' . . 

Used primarily by mailbox components* to pass a message to the Main program so that it 
can- be displayed by the appropriate message handling component. Email main takes the 
message argument (em_MailData, looks up the Mimetype of the message, and invokes the 
appropriate message handler to display the message. 
*/ 

void emh_passMessage ( 
em_MailData, 
em_MessageNumber 

) 

1********************************************************** 

* * * * / 

/* emh_getMessage ' ^ ' 

Returns the message (em_MailData) with Number MessageNumber from the 
MailboxName of the current user. Can be used by installable components to retrieve 
specific messages from the user's mailboxes. 

If this is called with the messageNumber set to 0, email main assume the typeOrBoxName 
argument is a mimetype and returns a new message strucOire. Message handling 
components should call emh_getMessage with the number set to 0 and the mimetype 
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whenever a new message is started. Normally this should be done whenever an active 
message is trashed. 

*/ , ■ • ■ 

em_MailData emh_getMessage ( . — 

em_MessageNumber - ■ . . 

str typeOrBoxName 

) • • • _ ■ ■ 



************************************* **********'^******** 

/* emh_eetRegisteredUsers . . , ^ -j.- j 

Returns a list of usemames for the users that are registered with the KidCode system, i.e. 

that have been added as users by the User Adminstration part of the Main Email Program. 

This is the same list of users that appear in the logon listbox when the progratn is started 

up It may be used by installable components to create listboxes for filling address tields 

in messages or for checking on whether a particular addresses external to the system. 

*/ 

em_RegisteredUsers emh_getRegisteredUsers ( . 

) , ' ■ . 

i********************* *********************** ************** 

* * * * / . , ...... 

/* emh_sendMessage , • ^ ^- . 

Email Main sends the message argument (em_MailData) by either forwardmg to an 
external mail server or, if it is a registered KidCode user, writing the message to the user s 
incoming mail mailbox. 
*/ 

void emh^sendMessage ( " ^ ^ • • ■ ' ^ • 

em_MailData 

) 



1 ******** * * * * * * ^ * *;* * * *;*>;,** * * * * 

■****/, , ■■ ■ .. / ' :[: -r^- ■ .i '.' '.' ; ' " : 

/* emh_saveMessage . ' r- ■ ' . , j ' 

Email Main saves the message argument (em.MailData) for the .curreiitly logged on user 
by writing the message to the user's "notes in progress" mail mailbox. 
*/ 

void emh_saveMessage ( 
em_MailData 

) 



/ 



***************?*<********************;*************** 
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/* enih_disableButlon 

It is recommended that this function be used carefully. Normally Email Mam controls 
the state of all the buttons available to users to access message handling of the mam 
program (i.e. buttons in the purple left hand panel). This function can be used to request 
that Email Main disable the button specified by the argument, ButtonName. If the button 
is disabled - whether it was already disabled or is disabled as a result of the function call - 
the function will return TRUE, otherwise it will return FALSE. The calling component 
should check on whether the function call succeeded arid proceed accordingly. 
*/ 

em„Retum Value emh_disableButton ( 

str ButtonName 

) 



* * * * / 

/* emh„enableButton 

It is recommended that this function be used carefully. Normally Email Mam controls 
the state of all the buttons available to users to access message handling of the main 
program (i.e. buttons in the purple left hand panel). This function can be used to request 
that Email Main enable the button specified by the argument, ButtonName. If the button 
is enabled - whether it was already disabled or is disabled as a result of the function call - 
the function will return TRUE, otherwise it will return FALSE. The calling component 
should check on whether the function call succeeded and proceed accordingly. 
*/ 

em.RetumValue emh_enableButton ( 

str ButtonName 

) 

API Functions Required Implementation of all Component Types 



***************************************************** 
/* emc_startMeUp 

Used by Email Main to tell an installable component to start. This function will execute 
prior to initialization of the component's data structures. Which should only be intialized 
after the component receives the ernc_initWindow call from Email Main. . 
This function is necessary for this Director/Lingo implementation^ 

*/ ' ' • ■'• - 

em_Retum Value emc_startMeUp ( 
) 



/ 

************************************************** 
* * * * / 

/* emc_initWindow 

Used by Email Main to tell an installable component to initialize it's data structures and 
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prepare its graphical display. The component is passed the usemame of the current usei 
If it requires additional user information in order to initiahze, it can call emh_getUserln 
within it's implementation of this function. 

em_RetumValue emcJnitWindow ( 
em_UserName 

) 



****/ 

/* emc^closeWindow. ' u u a 

Used by Email Main to tell an installable component to free all memory that it has used, 
close it*s window, and shut down. 

*/ • ■ ■ 

em„RetumValue emc_closeWindow ( 

-) 

1************************************************ 

* * * * / 

/* emc eetComponentlnfo xi .tt^ 

Used by Email Main to get required information such as componentName, componentlU, 
etc. from the installable component. 

*/ ■ .. - . . ■ 

em_ComponentInfo emc_getComponentInfo ( 

) 

API Functions required of a Mailbox Handler Component 

1 ******************** * * * ***** * * *' * **********•**'******** ** * * 

* * * * / 

/* mbx_getMessageNumbers ' t ^ • .u 

Used by Email Main to get the message number of the currently selected message in the 
mailbox browser. If no message is selected, the list should be empty. 

*/ . . 

list of int mbx_getMessageNumbers ( 

1*******************************************************^ 

* * * * / 

/* mbx_getMessage 

Used by Email Main to get the message data structure of the message with * 
em_MessageNumber from the mailbox currently displayed in the mailbox browser. If 
the function fails, e.g. if there is no message with the given message number, the function 
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returns an empty list. 

*/ 

em_MailData mbx_getMessage ( 
em_MessageNumber 

) 



i ************* iT* *********************************** 

/* mbx_trashMessages ' , ^ ^ a . 

Used by Email Main to tell the mailbox component to update it s display and it s data 
structures to delete messages with messageNumbers in the argument list. If the function 
fails, e.g. if one of the message numbers is invalid, the function returns FALSE, otherwise 
it returns TRUE. This function should be implemented so that it does not perform partial 
deletes, i.e. either it succeeds in deleting all of the messages in the list or it should not 
delete any message. 
*/ 

em_RetumValue mbx_trashMessages ( 
list of em_MessageNumber 

) - . - 

c **************************************************** ****** 

/* mbx_openMailbox j • u 

Used by Email Main to tell the mailbox component to display the mailbox passed m the 
argument. 

*/ 

em_RetumValue mbx_openMailbox ( 
em_Mailbox 



Functions required of a Message Handler Component 



l-* *'* * *'**.** * * * * ** * * * * *■*;* * * * * *.* * * * * * *.* ** ***** * * * ************* 

* * * *y ■ ... ' , 

/* msh_sendMessage . . , j 

Used by Email Main to tell a message handling component to pass back a fully completed 
message data structure so that it can be sent to the recipient specified in the message's 
address field. The message handling component should update it's display as appropriate 
for a message that has been sent. It should also change it's state to #display mode because 
a message that has already been sent should not be editable. If the function fails, e.g. if a 
fully completed message cannot be constructed (for example, if the user has not specified 
a message recipient), the function returns an empty list. 

The message handling component will normally control all dialogs with a user that pertain 
to the message under construction. For example to alert the user to the fact that a 
message recipient is required. However, if the message handling component fails to pass 
back a properly formatted, completed message data structure, (or an empty list 
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acknowledging failure) Email Main will detect the error and alert the user about 

or fields that have not been specified. 

*/ 

em_MailData msh_sendMessage ( 
) 



***** **************************************************** *^ 

* * * * / 

UseTby EmaU Malfto pass a message data structure to a message handling component 
so that it can be displayed. The message handling component should display he message 
in the specified mode - either #author or #display. If the em Mode argument is #d splay 
the message should not be editable. Otherwise the message should be opened so that it 
can be edited. 

If the function fails, e^g. if an error is detected in the message body, the message handler 

returns FALSE, otherwise the message handler returns TRUE. 

*/ 

em_Retum Value msh_openMessage ( 
em_MailData 
em_Mode 

) - ■ " ■ •■; \ 

C***********.**************************^************^* ****** 

* * * * / . . 

UsS^y'^Ellian'Mam^to inform a message handling component to display the currently 
active message for editing as a reply. In order to reply the message handing component 
will generally create a new message with the mode set to #author. The new message body 
may contain material from the original message that is being replied to. In addition, 
message handling components that handle different player roles may. enable or disable 
various role specific tools at this time. For example, the Rebus message handler will 
change the RebusState of the new message and enable guessboxes as appropriate. 

If the function fails, e.g. if an error is detected in the message body, the message handler 
retums FALSE, otherwise the message handler renims TRUE. 

*/ 

em_RetumValue msh_replyMessage ( 
) 



i^*^*^** *************************************************** 
* * * * / 

/* msh_clearMessage 

Used by Email Main to inform a message handling component that the current message 
should be cleared from the display and from the message handling component s data 
structures. This function is used, for example, when the user indicates they want to trash 
the current message by clicking on the "trash" button m the Email Main purple panel. 
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If the function fails, the message handler returns FALSE. Otherwise the message handler 

returns TRUE. 

*/ 

em_RetumValue msh_clearMessage { 
) 



+ *■* ****** * * *************************************** 

* * * */ 

/* msh_printMessage u u u 

Used by Email Main to inform a message handling component that a message should be 
printed. This function is used, for example, when the user indicates they want to print the 
current message by clicking on the "print" button in the Email Main purple panel. 
When the argument^ em.mailData, is an empty list, the message handler component 
should print the currently active message. Otherwise the message handler component 
should print the message argument. Normally, if the message handler component has 
been fully initialized and is displayed in a window, Email Main will call this function with 
an empty list for an argument. 

The function may also be used by the Main Email program to have a message handler 
print a message even though the message handler component has not been fully 
initialized and displayed in a window. For example, this will occur if an active mailbox 
component receives a print request from Email Main for a message that has been selected 
in the mailbox browser. In this case, Email Main will send a request to the appropriate 
message handler component to print the message without fully starting it up and 
initializing its window. Therefore the message handler should implement the 
msh_printMessage function so that the following sequence of function calls succeeds - 
emc_startMeUp, msh„printMessage(message). 

If the function fails, the message handler returns FALSE.: Otherwise the message handler v 
returns TRUE. =• ' : . 

*/• ' . • • ■ ' ■ - ■ ■ 

em RetumValue msh_printMessage ( . : , ; 

em_MailData . 

) ■ ■ \' ■ • ■ ■ : ■ - . "• . . . 
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Claims: 

1. An electronic mail client, comprising: . . , . 

a) a plurality of authoring components, a first of said plurality of authoring components for 
creating a representation of a document including other than text; 

b) encoding means for automatically encoding said representations created with said authoring 
components into an Internet-compatible email message; and . 

c) decoding means for automatically decoding said representations encoded by said encoding 

means. 

2. An electronic mail client according to claim 1 , wherein: 

said plurality of authoring components include at least one installable component. 

3. An electronic mail client according to claim 1, wherein: 

said plurality of authoring components includes at least one component selected from the 
group consisting of a game component, a spreadsheet component, and a graphic editor 
component. 

4. An electronic mail client according to claim 1, wherein: , / 

said plurality of authoring components includes at least one component selected from the 
group consisting of a database component, a presentation component, and a puzzle component. 

5 . An electronic mail client according to claim L wherein: 

said encoding means includes MIME-compatible encoding, means. 

6. Anelectronic mail client according to claim 1, wherein: . . ^ ^ , • 

said encoding means includes means for creating a MIME file and means for creating a 
- multipart MIME message, , ^ ■ ,*/ 

each of said authoring component cooperating widi said encoding means such that a 
creation of said MIME file and said multipart MIME message is transparent to a user. 

7. An electronic mail client according to claim 6, wherein: 

said decoding means includes means for concatenating a multipart MIME message and 
means for decoding a MIME file, 

each of said authoring component cooperating with said decoding means such that a 
concatenation of said multipart MIME message and said decoding of MIME files is Uransparent 
to the user. 
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8. An electronic mail client according to claim 1, further comprising: 

d) a plurality of installable mailbox/browser components, each of said mailbox/browser 
components displaying different types of documents in a user's mailbox. 

9. An electronic mail client according to claim 1 , further comprising: 

d) a plurality of installable mailbox/browser components, each of said mailbox/browser 
components displaying mailbox contents in a different style. 

10. An electronic mail client according to claim 1, wherein: 

said encoding means and said decoding means communicate bidirectionally with said 
authoring components/ 

1 1 . An electronic mail client according to claim 1 , wherein: 

at least one of said authoring components includes means for recognizing whether a user 
is an author or a reader and for responding differently to authors and readers. 

12. An elecu-onic mail client according to claim 1, wherein: 

at least one of said authoring components includes means for allowing a user to create a 
read-only document. 

13. An electronic mail client for a student and a teacher, comprising: 

a) a plurality of authoring components, a first of said plurality of authoring components for 
creating a representation of a text document and a second of said plurality of authoring 
components for creating a representation of a document including other than text; 

b) encoding means for automatically encoding representations created with said authoring 
components into an eniail message; and 

c) decoding means for automatically decoding said representations encoded with said encoding 
means, wherein ; , \ u : • . • — 

at least one of sdid authoring dbinipbhentS' includes means for determining whether the 
user is the student or the teacher. 

14. An electronic mail client according to claim 13, wherein: 

said plurality of authoring components include at least one installable component. 
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15. An electronic mail client according to claim 13, wherein: , 

said plurality of authoring components includes at least one component selected from the 
group consisting of a game component, a workbook component, and a graphic editor 
component. 

16. An electronic mail chenl according to claim 13, wherein: 

said plurality of authoring components includes at least one component selected from the 
group consisting of a database component, a presentation component, and a puzzle component. 

17. An electronic mail client according to claim 13, wherein; - 

said encoding means includes MIME-compatible encoding means. 

1 8. An electronic mail client according to claim 13, wherein: . 

said encoding means includes means for creating a MIME, file and means for creating a 
multipart MIME message, * 

each of said authoring components cooperating with said encoding means such that a 
creation of said MIME fde and said multipart MIME message is transparent to the student and 
the teacher. .. . 

19. An electronic mail client according to claim 18, wherein: 

said decoding means includes means for concatenating a multipart MIME message and 
means for decoding a MIME file, 

each of said authoring component cooperating widi said decoding means such that a 
concatenation of said muldpart MIME message and said decoding of MIME files is transparent 
to a user. 

20. A method of authoring a document and sending it by electronic mail, said method 
comprising: 

a) providing a document-authoring component which authors a document other than a plain- 
text document; 

b) providing a document-encoding component which encodes the document as Internet- 
compatible email; 

c) linking the document-authoring component with the document-encoding component such 
that documents generated under said document-authoring component are automatically encoded 
as Internet-compatible email. 
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21. A method according to claim 20, wherein: 

said step of providing a document-authoring component includes providing a plurality of 
document-authoring components, and 

said step of Unking includes linking each of said document-authoring components with 
the document-encoding component. 

22. A method according to claim 20, further comprising: 

d) providing a document-decoding component which decodes a received document encoded as 
Internet-compatible email; 

c) Unking the document-authoring component with the docunient-decoding component such 
that documents are automatically decoded. 

23. A method according to claim 20, wherein: 

the document-encoding component includes means for creating a MIME file and means 
for creating a multipart MIME message. 

24. A method according to claim 22, wherein: 

the document-decoding component includes means for concatenating a multipart MIME 
message and means for decoding a MIME file. 
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